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Overview of the Manual 


The UNIX WRITER'S WORKBENCH Software is a set of programs that 
helps experienced and inexperienced writers and editors evaluate and revise 
documents. Users of the WRITER'S WORKBENCH system may or may not be 
experienced UNIX system users. This manual provides detailed instructions 
for using the WRITER'S WORKBENCH programs in the UNIX system 
environment. 

This user's guide contains three descriptive chapters, an appendix, a 
glossary, a reference section, and an index. A reference card that 
summarizes the WRITER'S WORKBENCH programs and features is also 
available. 

Chapter 1, "Getting Started," provides information about using the 
WRITER'S WORKBENCH programs in the UNIX system environment. This 
chapter covers video display and printing terminals, command lines, 
defaults, error messages, and methods for changing your environment. 

There is also a detailed section on using deroff for text with formatting 
macros and reroff for text that is already formatted. 

Chapter 2, "A Tutorial Introduction to the WRITER'S WORKBENCH 
System," is divided into three exercises that lead you through typical work 
sessions and teach you how to enter commands, interpret the output, and 
make corrections to your text using the suggestions provided by the 
programs. The first exercise shows you how to get on-line help for the 
WRITER'S WORKBENCH programs, and the second exercise describes the 
wwb program in detail. The third exercise covers proofvi, the new 
interactive proofreading program. 
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Chapter 3, "The WRITER'S WORKBENCH System Manual Pages," presents 
a manual page for each program. Manual pages include the command line 
synopsis, a description of the command, definitions of the available options 
and arguments, lists of related programs, and examples. 

Appendix A contains a paper by Nina H. Macdonald that describes the 
rhetorical and psychological writing principles that underlie the WRITER'S 
WORKBENCH programs. 

The Glossary defines many of the terms appearing in this user's guide, 
including computer and UNIX system terms, all WRITER'S WORKBENCH 
programs, statistical terms, and grammatical, writing, and editing terms. 

The Reference section may be useful to you both for writing and editing 
and for a better understanding of the WRITER'S WORKBENCH programs and 
the UNIX system. 

The Index lists the page numbers where information on keywords can 
be found. 

Type Styles Used in this Manual 

Four different type styles are used in this manual: 

■ Palatino type, which looks like this, is used for the main body of the 
document. 

« Bold italic type is used to show that the italicized information is not to be 
taken literally. For example, when the word file is shown in italics, it 
means that you are to type in the actual name you have given your file, 
not the word "file." 

■ Bold type is used in two ways in the text: to highlight WRITER'S 
WORKBENCH system command names, and to show what you would type 
at your terminal keyboard. 

■ constant width type is used for examples that show a dialogue between you 
and the computer; your input and the computer's response will be shown 
in this type style. 
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How to Check Your Access to the WRITER’S WORKBENCH 
System 

Release 3.0 of the WRITER'S WORKBENCH system runs on UNIX System V 
Release 2.0 and higher. To see if your UNIX system has the WRITER'S 
WORKBENCH system, type the following after you log in. 

wwb —V 

If the system responds with 

w*4> version 3.0: : 

(or with numbers greater than 3.0), you have the WRITER'S WORKBENCH 
programs described in this manual. If you have a version number that starts 
with 2.0, you do not have the release that matches this documentation; you 
have the previous release. 

If the system responds something like 
sh:wwb: not found 

call your UNIX system administrator or computer center to ask if the 
WRITER'S WORKBENCH system is available and what the full pathname is for 
the directory in which the programs are stored. Your system administrator 
can help you add the correct pathname to your .profile so that you will be 
able to access the WRITER'S WORKBENCH system. 
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Introduction 


This chapter will help you get started using the WRITER'S WORKBENCH 
system. The sections included cover the following topics about your 
environment and about the programs: 

• creating text files 

■ video display and printing terminals 

■ command lines 

• options and arguments 

■ defaults 

■ program input 

• error messages 

• formatted and unformatted text: deroff and reroff 

■ tailoring commands 

The WRITER'S WORKBENCH programs cannot teach you all there is to 
know about good writing, although you should learn new things about 
writing from using them. For more information on the principles of good 
writing, see Strunk and White's The Elements of Style (1972) and Lanham's 
Revising Prose (1979). Appendix A in this manual contains part of an article 
titled "The Writer's Workbench System: Rationale and Design" (Macdonald, 
1983), which you will also find useful. 
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Creating Text Files 


Before you can create text files, you must have your own login directory 
(if you do not, talk to your UNIX system administrator about obtaining one). 
To create text files and use the WRITER'S WORKBENCH system, you should 
be familiar with the UNIX operating system, the directory and file structure, 
and a UNIX system text editor, such as ed or vi. To use the interactive 
correction program, proofvi, familiarity with the vi screen editor will be 
particularly useful. See the UNIX System V User Guide and the UNIX System 
V Editing Guide for an introduction to these topics. 

You may also need to know formatting commands (nroff or troff) and 
ms or mm macros. The text you want to evaluate with the WRITER'S 
WORKBENCH system should be entered into a file just as it would be for any 
document. Your text may contain formatting commands and mm or ms 
macros; you can also use a text file that is already formatted. See the UNIX 
System V DOCUMENTER'S WORKBENCH™ Introduction and Reference Manual and 
the UNIX System V DOCUMENTER'S WORKBENCH Software Macro Package 
Reference for information on nroff, troff, mm, and ms. 

The rest of this chapter describes in detail how to use the WRITER'S 
WORKBENCH system commands. 
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Reading Output from a Video Display or 
Printing Terminal 


Depending on the type of terminal you are using, you may want to 
follow one of the methods below to read the output you will get from the 
WRITER'S WORKBENCH programs. 

• For those programs that provide more than one page of output (in 
general, the text analysis programs), it may be convenient to redirect the 
output to a printer. See your system administrator to find out how to 
send text to local printers. 

■ If you are reading the output on a video display terminal (VDT), you can 
type Ctrl-S (press the CONTROL key and character S at the same time) to 
stop the printing temporarily. When you are ready to read more of the 
output on your screen, type Ctrl-Q to pick up where you left off. 

For example, if your file is named filel, and you want to use wwb to 
analyze it, type: 

wwb filel 

Typing this command by itself will put the results directly onto your 
screen. Use the Ctrl-S, Ctrl-Q sequence to stop and then restart the 
output. 

• Some programs, in particular those that present rules of grammar and 
punctuation, automatically page their output on a VDT one screen at a 
time. For output that is not automatically paged, you can use the pipe 
symbol ( | ) and the pg (page) command to display a screen of output. 
Type: 

wwb filel | pg 

You will see a colon prompt at the bottom of the screen of output; press 
the RETURN key, and another screen of output will be presented. 

■ You can store the output in a file by redirecting the standard output of 
the WRITER'S WORKBENCH programs into a file that you name to be 
printed or looked at later. You can use this method whether you are 
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working at a printing terminal or a VDT. If you type 

wwb filel > filel.out & 

you will create a file called filel.out, which contains your wwb output. 

Be sure you do not already have a file called filel.out, because it will be 
overwritten with the output from wwb. 

The ampersand (&) at the end of the command line is a request that the 
program process in the background. You will get the system prompt back 
after you press the RETURN key, and you can execute other commands 
while wwb is analyzing your file called filel. In a few minutes, you can 
read or print filel.out as you would any other file. 
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Command Lines 


The procedures for using each of the WRITER'S WORKBENCH system 
commands are the same. In most cases, the morestyle command is used in 
the following sections to illustrate command line synopses, options and 
arguments, and defaults. 

The Prompt 

Once you have entered your login and password, the system will 
prompt you with a dollar sign, a percent sign, or some other prompt, like 
this: 


$ (or %) 

The prompt means the operating system is ready to accept an instruction 
from you, that is, you can enter a command. 

The Command Line Synopsis 

In response to the prompt, you need to enter the appropriate WRITER'S 
WORKBENCH system command line. To determine what you want a 
command to do, you must be able to read the command line synopsis. The 
synopsis is a shorthand that lets you know the capabilities of the command. 

There are three ways to obtain a copy of the command line synopsis: 

• You can look at the section called SYNOPSIS on the manual page in 
Chapter 3. 

• You can type in at the terminal the following command line 

man commandname 

to see an on-line copy of the manual page. (Most do not include the 
EXAMPLE section shown in Chapter 3; further, manual pages are available 
on the AT&T 3B5 and 3B20 Computers, but not on the 3B2 Computer), 

. You can type the command name followed by — O: 

morestyle — O 
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The — O (uppercase letter "O") option can be used with all programs. It 
returns the command line synopsis and a short description of each option 
and any arguments available with the command. The output given by 
morestyle — O is shown in Figure 1-1. 

Figure 1-1 Output of morestyle — O 


$ morestyle -O 

rrorestyle [— lsOV] [H. g ! n] [-mm ! n ! s] [reroff -options] [ ] file ... 


— 1 Print long output. 

-s Print short output. 

-O Print ccmnand synopsis and this list. 

-V Print the program version number. 

-i g Ignore lists in the analysis. 

— i n Include lists in the analysis. 

-mm File contains nm macros. 

-m n File contains no macros; the text is already formatted. 

-ms File contains ms macros. 


reroff options: (Use only with -m n option. ) 

-h Don't remove hyphens. 

-B num . . . .The input text has between-line spacing equal to "num." 
—I num ....The standard indent (margin) is "num" spaces. 

-P num . . . .The standard indent for paragraphs is "num" spaces. 


For now, we'll look at the command line synopsis; more on the option 
descriptions later. The first word on the command line synopsis is always 
the command. It is followed by options, which are shown in brackets (the 
brackets are never included when you type in the command line). Any 
item shown in the synopsis that is not in brackets must be typed on the 
command line so the program will perform correctly. 

Finally, most commands perform on an operand, which is usually, but 
not always, a file. The word "file," followed by ellipses (...), shows that 
morestyle takes as an operand one or more files. Remember, the word "file" 
is to be replaced by the name of the file (or files) you want analyzed. 
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Options and Arguments 


Options, always shown in brackets in the command line synopsis, alter 
the way the command operates. Some options can take one or more 
arguments; arguments alter the way the option operates. 

For morestyle, —1, — s, — O, —V, — i, and — m are options. Both — i and 
-m take an argument. The vertical bars ( | ), which mean "or," separate the 
possible arguments. Whenever you see a vertical bar, it means you must use 
one, and only one, of the arguments. If you wanted morestyle to include 
lists in its analysis of your text, you would use — i n on the command line. 

The command line synopsis for morestyle also shows that you can use 
reroff -options. The section on option definitions given with morestyle — O 
includes the possible reroff-options available and also states that you can 
only use these options when you use -m n. You can read more about the 
reroff-options on the reroff manual page in Chapter 3, but for now, note 
that you can replace the option shown in the synopsis with one or more of 
the reroff-options available when you use — m n. 

The optional double dashes can be used on the command line to 
indicate the end of the options. They are needed with some UNIX system 
commands and are included here for consistency. You will probably not 
need to use them. 

Figure 1-2 shows the notation used in command line synopses together 
with an example and explanation of each item for the murky command. 

The murky command is used in the figure because its command line 
synopsis includes most of the symbols used in the WRITER'S WORKBENCH 
system commands. 

You can see that there are two more option /argument combinations 
used on the murky command line. The — p option accepts arguments that 
are separated by commas in the synopsis. You can use as many of these 
arguments as you want, given in any order, on the command line. You can 
separate them with commas on the command line, or you can leave a space 
between the arguments and enclose all the arguments in double quotes ("). 
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The — R option requires that a number replace the argument num on the 
command line. 

Figure 1-2 Notation Used for Command Line Synopses 


Command Line Synopsis 

murky [-alsOV] [-m m | n | s] [-p c,p,r,cp,cr,pr,cpr] [-Rnum] [reroff-options] [ — ] file ... 


NAME 

COMMAND LINE 
SUMMARY 

USAGE 

EXAMPLE 

EXPLANATION 

Command 

murky 

murky 

The command name as it should be 
typed. 

Option(s) 

[— alsOV] 

— s 

An option alters the way a command 
performs. The option(s) shown inside 
the brackets may be typed in after the 
command name and a space (the 
brackets, which signify optional input, 
are never typed in). Options that do 
not take arguments may be grouped 
after a single hyphen; options that are 
mutually exclusive cannot be used 
together on the command line. You 
cannot tell if options are mutually 
exclusive by reading the synopsis; you 
must read the descriptions in the 
manual pages. 

Argument(s) 



Arguments typically alter the way an 
option performs. Some options may 
take one or more arguments. 

1. 

[— m m | n | s] 

— m n 

One of the arguments shown 
separated by vertical bars must be 
typed in as an argument to the option 
preceded by a space. The vertical bar 
means "or"; no more than one 
argument can be used. 
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Figure 1-2 Notation Used for Command Line Synopses (continued) 


Command Line Synopsis 


murky [-alsOV] [-m m | n | s] [-p c,p,r,cp,cr,pr,cpr] [-R num] [reroff-options] [ — ] Hie ... 


NAME 

COMMAND LINE 
SUMMARY 

USAGE 

EXAMPLE 

EXPLANATION 

2. 

[— p C,p r T,Cp,CT f pT f CpT] 

-p c,pr 

or 

-p "c pr" 

One or more arguments separated by 
commas (or separated by spaces and 
quoted) can be given after the option 
and a space. The option and first 
argument must be separated by a 
space. 

3. 

[— R num] 

-R 12 

A value must replace the argument 
variable (num) on the command line. 

reroff options 

[reroff-options] 

-h -P 5 

reroff options can only be used with 
the — m n option on already-formatted 
text. These options (see the reroff 
manual page) determine hyphenation, 
between-line spacing, the left-hand 
margin, and the paragraph indent in 
the output. 

Double hyphen 

[--] 


The double hyphen may be used to 
identify the end of options on the 
command line. 

Operand 

Hie ... 

filel file2 

The object of the command's action is 
called the operand. The operand is 
usually a file. In this case, one or 
more filenames must be typed because 
Hie is not in brackets on the command 
synopsis line (brackets signify optional 
input on the command line). 


Example 

murky -s -m n -p c,pr -R 12 -h -P 5 — filel file2 
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Entering Commands 


When you enter commands, there must be a space between the 
command name and the options, between options that take arguments and 
those that do not (options that do not take arguments can be grouped 
together), and between the options and the operand. Each option or group 
of options is preceded by a hyphen. 

Some options are mutually exclusive; you can only use one or the other 
on the command line. In general, the mutually exclusive options are 
bundled in the first set of brackets in the command line synopsis. And 
some options can only be used alone on the command line, such as — O and 
-V. 
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Defaults 


How do you know which command line is the appropriate one? How 
do you know which items— which command options, which arguments— to 
include when you type in a command line? It depends on what you want 
the WRITER'S WORKBENCH system to do. Some of the programs 
automatically use certain options and arguments that have been established 
as defaults. 

A default is a procedure for handling a task that the system has been 
programmed for in the absence of other instructions. The default is the 
automatic, routine procedure. In the descriptions of the options in the 
manual pages, the defaults are always identified. When you look at the 
morestyle manual page, you can see that three options are written into the 
program as defaults: 

■ —1 produces a long version of the output 

■ — i g ignores list items during text analysis 

■ — m m eliminates mm macros and related text from the text analysis 

Suppose you want to run morestyle on a text file called filel. morestyle 
is a single WRITER'S WORKBENCH system command that runs four other 
programs: abst, diversity, neg, and topic. 

You know that the command line should at least include these items: 
morestyle and the filename, filel, because neither appears in brackets in the 
command line synopsis. If you want morestyle to execute the three default 
options listed above as it runs on filel, type the following command line: 

morestyle filel 


However, there are several options that you may want to use to instruct 
morestyle to perform differently, in which case you have to override the 
defaults. To override a default, type in the option that you want instead on 
the command line. 
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Suppose that you want morestyle to produce the short version of its 
output instead of the long version (the default). Then your command line 
would look like this: 

morestyle — s filel 

And if you want morestyle to include lists in its analysis, your command 
line could look like this: 

morestyle — i n — s filel 


The command name, morestyle, is typed in first, followed by the 
command options and arguments (— s and — i n), given in any order. The 
last item is the operand, which is the name of the file (filel). 

Each WRITER'S WORKBENCH system command is used in the same way. 
Once you know what you want the WRITER'S WORKBENCH system to do and 
which command will do it, you can type in the appropriate command line. 


1-12 


WRITER’S WORKBENCH USER’S GUIDE 



Options Applicable to All Programs 


There are two options common to every WRITER'S WORKBENCH system 
command, although most commands also accept other options. The two 
common options are — O and —V. 

Command Line Synopsis and Option Definitions (— O) 

The — O option typed after a command gives you the command line 
synopsis, a list of all the options applicable to the command, and a short 
description of each option and any arguments. The — O option is typed 
after the command name without any other options or an operand. The 
short option definitions given with — O should serve as on-line memory 
joggers; each of the options is described in more detail on the manual pages. 

WRITER’S WORKBENCH System Version Number (—V) 

The -V option gives you the WRITER'S WORKBENCH system version 
number of the command you type. It too is typed after the command name 
with no other options nor an operand. —V gives the version numbers for 
the shell file, C or lex file, and library files for the program. The version 
numbers are separated by colons; a blank field (two colons with a space 
between in a row) represents an unused category. Version numbers may be 
necessary in reporting problems with a command. 

$ wwb — V 

wwb version 3.0: : : 

This example shows you have version 3.0 of the wwb shell file, wwb has 
no C, lex, or library files of its own. 


GETTING STARTED 


1-13 


Options Applicable to Many Programs 


Long and Short Versions (—1 and — s) 

Fifteen WRITER'S WORKBENCH programs have the long, — 1, and short, 

— s, options: abst, consist, continge, diction, diversity, morestyle, murky, 
neg, proofr, prose, sexist, spellwwb, switchr, tmark, wwb. With —1, the 
default, the programs produce a long version of the output, which includes 
explanations and suggestions. This version is best for new users. If you use 
the — s option on the command line, the programs produce a short version 
of their content, with no explanations or suggestions. This version is best 
for experienced users. 

You can change your UNIX environment to specify that — s be the 
default. Edit the file called .profile in your $HOME directory. (Files that 
are preceded by a dot, such as .profile, can be listed by typing Is —a.) Every 
time you log on, this file is executed to establish your UNIX system 
environment. To change the default to — s, add the following two lines to 
your .profile using a UNIX system editor: 

WWBLEV=s 
export WWBLEV 


If you change the default to — s in your .profile, and then you want to 
see the long version of output from a WRITER'S WORKBENCH program, 
specify —1 on the command line to override the — s. If you later want to 
make —1 the default again, then reset WWBLEV=1 in your .profile or remove 
the two lines. If WWBLEV is not set, the programs that use the long and 
short versions will assume —1 unless you tell them to use — s. 

Formatting Options (— m m | n | s) 

There are some words in the UNIX system vocabulary that you need to 
know when using the WRITER'S WORKBENCH system, nroff is a text 
processor that formats text for output devices. You may be using troff 
instead, which prepares text for photocomposition, nroff and troff process 
text files that are interspersed with lines of formatting commands; they 
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format and paginate text according to the instructions given by these 
formatting commands. 


There are several macro packages that can be used with nroff and troff; 
the most commonly used are the mm and ms macros, which are general- 
purpose macro packages. Macros group several formatting commands under 
one name to do a specific job, such as to format a heading, paragraph, or list. 
Your specific documentation needs will determine which you use. 

Twelve WRITER'S WORKBENCH programs automatically run deroff to 
remove nroff, troff, and mm formatting commands and associated text that 
is not part of sentences from the input file: aero, conscap, consist, mkstand, 
morestyle, murky, parts, prose, style, switchr, topic, wwb. The default 
(— m m) is for these programs to assume the file contains mm macros if 
WWBFMT=m or if WWBFMT is not set in your .profile. When your text 
contains ms macros, you must use — m s on the command line or set 
WWBFMT to s. 

You may, however, have input text that is already formatted, in which 
case you must request that the reroff program identify text that is not part 
of sentences and eliminate that text from the analysis. To run reroff on 
already formatted files, WWBFMT must be set to n, or you must use the 
— m n option on the command line. 

You can change the default (— m m) the same way as shown earlier for 
the WWBLEV variable. To set WWBLEV to n, edit your .profile to add the 
following two lines: 

WWBFMT=n 
export WWBFMT 


If you do change the default in your .profile, and then you want to use 
one of the other arguments to — m, type in the other option and argument 
on the command line. If you later want to make — m m the default, reset 
WWBFMT=m or remove the two lines from your .profile. 

For — m m and — m s, the input text must contain standard UNIX system 
mm (default) or ms formatting commands, including text sometimes found 
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in formatting header files, which contain formatting commands and 
definitions of macros. Use of nonstandard macros may cause incorrect 
sentence breaks, which could result in faulty text analysis, ms macros are 
available only on some UNIX systems. 

(For a complete discussion of deroff and reroff, see "Analyzing 
Formatted and Unformatted Text: Using deroff and reroff.") 

Ignore and Include Lists (— i g | n) 

You can request that eight WRITER'S WORKBENCH programs ignore 
(— i g) or include (— i n) list items in the input text as defined by mm 
macros: mkstand, morestyle, parts, prose, style, switchr, topic, wwb. If 
the text has many lists of nonsentences, use — i g (the default). If the lists 
are complete sentences, use — i n so they will be analyzed as part of the text. 
The — i g default option can only be overridden by typing — i n on the 
command line. 

Dictionary Option ( — d) 

Nine commands have the — d option, which prints the location of the 
standard WRITER'S WORKBENCH system dictionary for the command: abst, 
diction, diversity, neg, sexist, spelltell, tmark, worduse, wwbhelp. (This 
location may not be the same on all UNIX systems.) Use the — d option 
alone on the command line after the command name. 

After you obtain the location of a dictionary, you can display or print 
the dictionary with the UNIX system cat (concatenate) or pr (print) 
commands. See the UNIX System V User Guide for descriptions of these two 
commands and the manual pages for the commands listed above for more 
information on WRITER'S WORKBENCH system dictionaries. 
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Program Input 


There are two ways of showing the filename or other program input: 

■ If the filename or other input is enclosed in brackets, the program takes as 
input either a file or any UNIX system standard input in one of four ways. 
Using the punct program as an example, its synopsis line is: 

punct [-OV] [ — ] [- | file ... ] 

The four types of input punct can take are shown below: 

1. The program takes input from a file named filel: 

punct filel 

2. The program takes output from another program, for example, from 
the cat program, as input; the command name may follow a UNIX 
system pipe ( | ): 

cat filel | punct — 

3. The program takes input as typed in at the terminal. Type punct, 
press RETURN, and then type in a test sentence followed by Ctrl-D, 
as shown below. 

$ punct 

This is a test sentence (to test punct. 

Ctrl-D 

0 double quotes and 0 single quotes 

0 apostrophes 

1 left parentheses and 0 right ones 

Because of the unbalanced parentheses, the following check for mistakes 
may make errors. 


no errors found 


GETTING STARTED 1-17 


4 . The program takes standard input redirected from a file: 

punct < filel 

• If the filename or other input is not enclosed in brackets, you must give 
the program a file as input. The synopsis line for the aero program is: 

aero [— 1 OV] [— m m | s | n] [ — ] file ... 

A command line for aero must include a filename: 

aero filel 
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Command Line Echo 


Generally, programs that analyze a text file echo the command line they 
are using after you press the RETURN key. The echoed command line will 
include any default options the program is using. For example, after you 
type 

aero filel 

the aero program will respond: 
aero -m m filel 

The echo means everything is working as it should. When a program 
cannot perform the command line you've entered, you will receive an error 
message. 
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Error Messages 


The WRITER'S WORKBENCH system tries to give consistent, informative 
error messages wherever possible. The most common types of error 
messages result from a command with no input, an unknown option, or an 
inaccessible file. In addition, match, prose, style, and wwb give an error 
message when a word or sentence is too long for parts to handle, prose 
and wwb give an error message if style is unable to produce a style table. 

These error conditions are described and an example is given for each in 
this section. If you are unfamiliar with the command used in the example, 
refer to the manual page for the command in Chapter 3 or type: 

man commandname 

(Note that manual pages are available on the AT&T 3B5 and 3B20 
Computers, but not on the 3B2 Computer.) 

Command with No Input 

Many WRITER'S WORKBENCH programs (the ones that do not take 
standard input) require input from a file or from another program. If you 
use one of these programs with no input file, the program will print its 
command line synopsis. The synopsis functions as a memory aid as well as 
an error message, for example: 

$ wvt> 

Usage: wwb [— IsOV] [— f style-file] [-1 gin] [-m minis] 

[-u t!e!o,standards-file] [reroff -options] [ ] file ... 

Unknown Option 

If you type an option that the program does not recognize, you will get 
an error message. 

$ wwb -q filel 
unknown wwb option — q 
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Inaccessible File 


If any of the programs cannot access a file you typed (a text file, style- 
file, dictionary-file, or standards- file), you will get an error message. A 
program may not be able to access a file for several reasons: 

• The filename may be spelled incorrectly. 

■ You may not have permission to read the file. 

• The file may be located in another directory. 

When a program cannot access a file, it suggests typing a more complete 
pathname. Suppose you are working in a directory that has a subdirectory 
named memos, and your file named filel is in the memos subdirectory. In 
the first command shown below, wwb returns an error message because it 
can't access the file; in the second command, the complete pathname is 
given so the command executes. 

$ wwb filel 

wwb can't access the file filel; 

try specifying a more cccnplete pathname. 

$ wwb memos/file 1 

(wwb output for memos/filel follows. ) 


Typographical errors can also yield error messages. 

$ wwb memos/flel 

wwb can't access the file memos/flel ; 
try specifying a more oarplete pathname. 

Wrong Type of Input File 

Some programs take certain types of files as input; for example, match 
only takes a style table as input. If you give it an ordinary text file, such as 
filel, you will get an error message. 

$ natch filel 

The file filel does not seem to contain a style table. 
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When you use the — u o, standards-file option with prose or wwb, it 
expects a standards-file with 14 lines, each containing four floating point 
(decimal) numbers (the output from inkstand). If you give it another type 
of file, for example, a style table, you will get an error message. 

$ prose —u o,styl.tnp filel 

The standards file is not fanratted properly. 

It should have 14 lines, each with 4 floating point numbers. 

Words or Sentences Too Long 

parts can only handle sentences that contain fewer than 248 words, and 
sentences that are shorter than 1500 characters. If you run parts, style, 
prose, or wwb on a file with sentences that contain too many words or too 
many characters, the program will run, but it will give you an error message 
telling you which sentences were too long, parts will analyze the first 248 
words of those sentences together with the rest of the text. 

$ prose —s lcmgsentfile 

prose -s -m m — i g -u t lcngsentfile 

Parts: (part.l): sentence 3 too many words. 

Only first 248 words will be used. 


Compared to technical papers. 


Reading grade level 


The error message came from a component of parts, which is run by prose. 
The prose analysis that follows the error message will include only the first 
248 words of the third sentence in longsentfile. 
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No style Table 

If deroff, the program that filters out formatting commands and 
associated text, filters out an entire file, style cannot produce a table, and 
prose and wwb have no stylistic scores on which to comment (see "What to 
do about Problems with deroff"). For example, if an entire file is in "no-fiH" 
mode, you will get the following error message. 

$ prose nofillfile 

prose was unable to produce style statistics for your input file. 

Either the input file was empty, or else the deroff preprocessor 
filtered out your whole file. This can happen for several reasons; 
check your input file to see which of the following applies. 

1. If your text is ccnpletely contained in lists, 

run prose again with the "-i n" option to include the lists. 

2. If your text is entirely in "no-fill" mode (preceded by a ,nf camand) 
or if it is entirely contained in displays or tables, 

then deroff filtered out all the text in no-fill mode, in displays, 

or in tables. Try removing those formatting catmands, 

or see the UNIX writer's WCMCBHCH Software User's Guide for help. 
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Analyzing Formatted and Unformatted Text: 

Using deroff and reroff 

Most WRITER'S WORKBENCH system programs (except the on-line help 
and customization programs) expect a text file (written in English) as input. 
Sometimes this file will contain formatting commands and associated non- 
sentence text and macros interspersed with the text; sometimes, a file may 
already be in its formatted form. The stylistic programs use deroff to 
remove the formatting macros from files that are not already in formatted 
form. 

deroff is a filtering program. It reads in the input text, filters out 
formatting commands and some associated text, and outputs the remaining 
text. The text that deroff outputs becomes the input for the WRITER'S 
WORKBENCH system program. This output consists of the words that make 
up sentences, but not other words such as headings and author's names. 

With the addition of the reroff program in this release, WRITER'S 
WORKBENCH programs can preprocess files that contain already formatted 
text and provide you with reasonable stylistic analysis of your text. When 
the input file does not contain formatting macros, reroff can be called to 
insert macros into the file so that the appropriate text elements can be 
excluded from the analysis by deroff. All the programs that run deroff 
(listed below), except mkstand, will run reroff when you request it on the 
command line with the — m n option. — m m is the default option, so the 
programs assume mm macros are used in the input file. 

deroff and the WRITER’S WORKBENCH System 

parts and the programs that run parts (mkstand, morestyle, murky, 
prose, style, switchr, topic, wwb) analyze text at the sentence level, parts 
uses deroff, and deroff depends on the presence of mm or ms macros and 
nroff/troff formatting commands to determine which words in the file are 
parts of sentences and should be analyzed. Three additional programs 
(aero, conscap, consist) also depend on macros (mainly to identify 
headings), although they do not analyze text at the sentence level. For all 
12 of the programs to work properly, deroff must first strip the input files 
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of macros and non-sentence text associated with them. 


All the programs that run deroff accept the -m m option (the default), 
which tells the program to run deroff to delete mm macros; the — m s 
option, which means deroff is to delete ms macros; and the — m n option, 
which means the file is already formatted and therefore contains no macros. 
Or you can set WWBFMT to s or n in your .profile file. In addition, the 
stylistic programs (all those that run parts except murky) also accept the 
— i g option (the default), which tells the program to ignore lists in the 
analysis, or the — i n option, which means the program should include mm 
lists. 

What deroff Does 

deroff filters out all nroff and troff formatting commands (including 
troff backslash constructions) as well as mm and ms macros. It does not just 
throw out these commands blindly, however. It interprets them so that it 
can decide whether to throw away any associated text. If a macro or 
formatting command commonly identifies text that is not part of sentences, 
deroff removes the text. It filters out text according to the following rules: 

1. It removes all text that falls between the following pairs of commands: 


.nf 

.fi 

(text in no-fill mode) 

.DS 

.DE 

(text in an mm static display) 

.KS 

.KE 

(text in an ms static display) 

.DF 

.DE 

(text in an mm floating display) 

.KF 

.KE 

(text in an ms floating display) 

.CD 

.DE 

(text in a long ms centered display) 

.ID 

.DE 

(text in a long ms indented display) 

.LD 

.DE 

(text in a long ms left-adjusted display) 

.TS 

.TE 

(text in a table) 

•EQ 

.EN 

(equations) 

$ 

$ 

(if $ is an eqn delimiter) 

.FS 

.FE 

(footnote text) 

.RL 

.LE 

(reference list text) 
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For example, when deroff finds a .nf (no-fill), it removes text until it 
finds a .fi (fill). 

2. By default, or if you use the — i g option with mkstand, morestyle, 
parts, prose, style, switchr, topic, or wwb, deroff removes all text that 
falls between the following pairs of mm list macros: 


.AL 

.LE 

(automatic list) 

.VL 

.LE 

(variable list) 

.DL 

.LE 

(dash list) 

.BL 

.LE 

(bullet list) 

.RL 

.LE 

(reference list) 


Note: If you use the — i n option with mkstand, morestyle, parts, 
prose, style, switchr, topic, or wwb, deroff does not remove text 
between the list begin and end macros, except for reference list text. 
Reference lists are always removed. 

3. It removes text that is centered with .ce. For example, if deroff finds a 
line with 

.ce 3 

it removes the next three lines of text. 

4. It removes text associated with author and title macros and with other 
"released paper" macros. 

5. It removes text labeled as headings with the ms macros .SH and .NH. 

6. It removes text that is on the same line as a macro, except when the 
macro is one of the font-change macros: .1, .B, or .R. Thus, if deroff 
finds a line with: 

.H 1 "First Major Heading" 

it removes the whole line. However, if it finds a line with: 

.1 "A Book Title" 

it removes the .1 and the quotation marks, but it saves the words, A 
Book Title. 
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Note: If a font-change line contains embedded quotes, deroff may not 
handle them properly. 

7. It reads and uses files named by .so and .nx. If deroff cannot find or 
open a file named by .so or .nx, it quits with the error message: 

deroff: Cannot open file filename 


What to do about Problems with deroff 

deroff depends on the correct use of commands and macros to 
determine which text to exclude. Thus, the programs may produce 
misleading results when run on formatted text. In that case, heading 
information such as the title, author's name, and date will all be included as 
part of the first sentence. Other headings will be considered to be part of 
the sentence following them. This interpretation leads to longer sentences 
(which lead to poorer readability scores for the document) and sometimes to 
incorrectly determined parts of speech (which lead to misclassified sentence 
types, among other things). Underlined or bold text produces a tripling or 
more of the length of such words since a word is defined as all the 
characters between blank spaces, including backspaces and underscore 
characters. 

Probably the most common problem with the 12 programs that run 
deroff is deroff's filtering out all or most text. That is, deroff passes no 
input to parts. If parts gets no input, style cannot produce a table, and 
prose and wwb have no stylistic scores on which to comment. This will 
happen, for example, if the entire file is in "no-fill" mode, that is, the entire 
text is between .nf and .fi. 

If deroff filters out an entire file, parts and style produce no message 
and no output, and prose and wwb will produce an error message. If 
deroff filters out most, but not all, of the text, the results are more subtle. 
Then the stylistic statistics are computed, but they are based on only a few 
sentences and they will be misleading. 

The following general procedures will help determine why the 
programs that run deroff gave you unreasonable output or no output: 
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• You can run style alone on your file and use the same formatting options 
as you used for the program that gave you unacceptable results (— m m or 
— m s and — i g or — i n). Check to see if you get a style table. 

If you get a style table, check the number of sentences style counted. If 
the sentence count is too low, deroff probably filtered out part of your 
text. If you did not get a style table, deroff probably filtered out your 
entire text. 

■ If you get no style table, or if the sentence count by style is too low, look 
closely at the formatting commands in your file. Check to see if you are 
using the ones that cause deroff to remove text. (See the partial list 
above.) For example, if you have a .nf (no-fill) command near the 
beginning of your file and you have no .fi (fill) command, deroff will 
remove the whole file. You can make a copy of your file and then add or 
rearrange formatting commands in the copy so that deroff will analyze 
the correct sections of text. 

If all your text is inside list macros, try running style, prose, or wwb 
with the — i n option. Then deroff will not filter out text in lists. 

• You can also run deroff alone to see what it does with your input text. 
But you must use the same version that the programs run. The WRITER'S 
WORKBENCH system version of deroff is slightly different from the 
standard UNIX system version of deroff. You will probably need to type 
the full pathname to access the WRITER'S WORKBENCH system version. 

For example, if the dictionaries on your system are stored in 
/usr/lib/wwb, then you should type: 

/usr/lib/wwb/deroff [options] file 

If the dictionaries are not stored in usr/lib/wwb on your system, then 
replace /usr/lib/wwb on the command line with the pathname where 
the dictionaries are stored. 
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When you run deroff in this way, you must give it formatting options; 
it does not have the usual defaults. For example, if you use mm macros 
and want to include lists, type: 

/usr/lib/wwb/deroff —mm file 

Note that this way of using deroff requires different options from the 
WRITER'S WORKBENCH system version of the command. 


Directly 

WRITER’S WORKBENCH 

System 

—mm 

— m m 

—ms 

— m s 

-ml 

8 

default 

— i n 


reroff and the WRITER’S WORKBENCH System 

reroff, a file unformatter, will take as input formatted text files: either 
text files produced by a text formatter, such as mm, or files that were typed 
in as though on a typewriter. It will produce a file containing the input 
text, interspersed with the appropriate mm formatting macros and 
nroff/troff commands to label headings, list items, paragraphs, and set-off 
text (for example, tables). 

reroff is available as an individual WRITER'S WORKBENCH system 
program, and it can be used as a front-end filter for the programs that 
require their input to contain mm macros: aero, conscap, consist, 
morestyle, murky, org, parts, prose, style, switchr, topic, and wwb. When 
you want to run reroff with these programs, you must use the — m n option 
on the command line. 

What reroff Does 

reroff compares a given line to the standard form of lines on its page. 

A line is considered in the context of the five preceding lines and up to 84 
following ones. The line is interpreted differently depending on its left 
margin, right margin, initial special mark (lists or headings), font (roman. 
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italic, bold), and various other features. In the simplest case, when a line is 
indented at the left-hand margin and ends at the standard right-hand 
margin, and it has no other distinguishing characteristics, it is simply 
displayed in the reroff output as it is (except that new sentences begin on a 
new line). Other lines are printed in relation to appropriate formatting 
macros. 

Specifically, reroff will take a formatted text file or files and do the 
following: 

1. Run files through col to convert the tabs to blank spaces and remove 
any escape characters. 

2. Identify and mark headings with .H macros (including the appropriate 
level or .HU). 

3. Identify and mark list items with the appropriate list header macro (for 
example, .AL, .VL, .BL) .LI macros, and list end macro, .LE. 

4. Identify tables, authors' names, paper titles, and other header 
information and surround these items with either .nf and .fi, or .DS 
and .DE. 

5. Identify and delete page headers and footers but send the deleted text 
to a special output file, reroff.err, so that the user can make sure that 
regular text was not deleted. 

6. Identify and mark the beginning of each paragraph with .P. 

7. Identify and delimit the abstract, if any, with .AS and .AE. 

8. Begin each sentence on a new line. 

9. Identify and mark page boundaries in the original text with .bp. 

10. Remove, but identify, italic, or underlining, and emboldened text. 

11. Identify standard features of the page to determine the standard indent, 
the paragraph indent, the right-hand margin if the text is justified, the 
rightmost column used if the text is not justified, and the spacing, 
double or single, by using only the lines that have not been identified 
as headings, list headers or list items, and page headers or footers. 
However, users can also supply the page indent, paragraph indent, and 
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spacing on the command line (see the description of reroff-options 
below). 

12. Write the values it has determined for each page (indent, paragraph 
indent, page length, justification, and spacing) to the file reroff.err. 
These values will be interspersed in that file with the discarded page 
headers and footers. 

13. Compress multiple contiguous spaces and leading white space except 
for lines categorized as parts of tables. 

14. Print shifts in font as \f 1, \f2, and \f3 unless the font change is implicit 
in the associated macro. (For example, the font shift for headings is 
taken care of by mm.) 

15. Rejoin hyphenated words (that are split across lines) unless the -h 
option is given. 

reroff’s Limitations 

reroff is not intended to create a file that will exactly duplicate the 
original file when formatted. The aim of the program is to label correctly 
the elements of the file that are important to text analysis programs. For 
use with the WRITER'S WORKBENCH system, then, reroff should label non- 
sentence text (e.g., headings, author information, tables, displays) so that it 
will not be included in sentence-level stylistic analyses, it should remove 
repeated non-sentence text (for example, page headers and footers) from the 
file, and it should label lists so that the user can choose to include or omit 
them from the analysis. 

reroff does have the following limitations: 

1. It will not always work properly if non-standard printing conventions 
are followed (for example, text that is all uppercase or all lowercase, or 
text that is all bold or underlined). 

2. It will only recognize sequential Arabic page numbers; it will not 
recognize, for example, Roman numerals in page numbers or section- 
page numbering. 

3. It will not recognize escape sequences, since they are removed by 
preprocessing. Thus, device-dependent sequences for format control 
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will not provide formatting information to reroff. If possible, 
formatters should be run in a mode that produces device-independent 
output text. 

4 . It will not recognize variable-item lists—those whose heading mark 
varies for each list item; such text will be formatted as displays or as 
displays and indented text. 

5. It will not identify footnote text; when footnotes are indented they will 
be classified as being part of a display. 
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Personal Tailoring of the WRITER’S WORKBENCH 
System 


This section describes how to use some features of the UNIX system to 
personalize the WRITER'S WORKBENCH system. It is intended for users who 
are familiar with the UNIX system shell. 

Adding Many Words to Your Spelling Dictionary 

There is a shortcut for adding many reported misspellings, which are 
actually spelled correctly, to your spelling dictionary. 

1. Correct all true misspellings in your file. 

2. Run spell on your file and direct the output to your spelling dictionary 
using double angle brackets (> >), as shown below. The angle brackets 
append the new words, rather than emptying the file first. 

spell myfile >> $HOME/lib/wwb/spelldict 

3. Then run spelladd with no words 

spelladd 

to sort and uniq the file. 

Problems with Nominalization Counts 

If you are writing about documentation, communication, or 
transmission, the count of nominalizations in your writing (given by the 
style, prose, and wwb programs) is being artificially inflated by your use of 
one of these words. You can test the count in several ways: 

1. To find out how many lines contain the word "communication," type 

grep — c communication filel 

You can subtract this number from the raw score on the style table and 
recompute the percentage. 

2. An easier way is to change all instances of "communication" to "qqee" 
globally. Write the output to some other file, and run the new file 
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through the program. Use this count of nominalizations as your true 
estimator. (The "ee" at the end of "qqee" guarantees that parts will 
interpret "qqee" as a noun.) 

Group Libraries 

A group of people may want to share dictionaries, for instance the 
spelling dictionary for spellwwb. 

Each person would need to access a group program spellwwb. (Only 
one copy of this program is necessary, but each login's PATH variable must 
reference it.) 

The new spellwwb file would contain the line: 

/usr/bin/spellwwb — f group-library-file $* 

where group-library-file represents the full pathname of the file you have 
chosen to use. The — f option tells spellwwb to search the file following it 
rather than the standard file, $HOME/lib/wwb/spelldict. To add words to 
this file you must use dictadd instead of spelladd. 
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About the Exercises 


This chapter includes three exercises that lead you through typical work 
sessions and introduce you to many of the WRITER'S WORKBENCH programs. 
Exercise I is a short introductory exercise that will: 

. help you become familiar with the WRITER'S WORKBENCH programs 

• explain the rules on split infinitives and punctuation that the programs 
check 

• describe an interactive program that explains the correct use of many 
English words and phrases 

Exercise II is a highly structured exercise on the use of the basic text- 
analysis programs. It covers the things you will probably want to know 
about every document you write. Using a text we have provided, you will 
learn how to: 

■ run the basic text analysis programs 

• interpret the output 

• make the recommended changes to your text 

Exercise III guides you through interactive error correction with 
proofvi. You will learn to: 

■ run the program to produce a reference file of errors to be corrected 

■ obtain on-line help with editing commands 

■ use the menu system to make changes interactively 

■ use the vi-like editor to make corrections 

To get started on the exercises, log in to your system. At the system 
prompt, which is usually a dollar sign ($), type the commands as you are 
instructed and read the output carefully. 

Remember, if you expect more than one page of output, you can send 
the output to a printer. However, if you are using a video display terminal 
(VDT) and will be reading your output on the screen, you can use the Ctrl-S 
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and Ctrl-Q sequence to stop and start scrolling on the screen. Or, you can 
use the pg (page) command, which will print 24 lines of output at a time: 

wwb myfile | pg 

You can also redirect output from the programs to a file that you can read 
on the screen or print like any other UNIX file, as shown below: 

wwb myfile > myfile. out 

See Chapter 1 for a more detailed description of reading program output. 

The output that you should receive in response to the commands is 
included in the exercises as figures. Use them to check that you are getting 
the right output from your commands. Because there may have been some 
recent updates to the programs, you might notice slight differences between 
your output and that shown in the figures. The substance, however, should 
be the same. 


2-2 
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Exercise I 


This exercise introduces some of the programs that give you on-line 
help with the WRITER'S WORKBENCH programs and with grammar rules. 
Before you begin, we recommend you use the wwbaid program to become 
familiar with the WRITER'S WORKBENCH system. Begin by typing: 

wwbaid 

at the system prompt, wwbaid is one of the programs that automatically 
pages for you, so there is no need to use any of the methods described 
earlier to read the output. 

After you press the RETURN key, the second screen of information you 
will see lists options to the wwbaid command that you should try; in 
particular, use wwbaid instruct to learn more about the WRITER'S 
WORKBENCH programs and how to use them. 

wwbinfo 

To print a summary of all the programs available in the WRITER'S 
WORKBENCH system, type: 

wwbinfo 

The system will respond by listing the WRITER'S WORKBENCH system 
commands, as shown in Figure 2-1. 
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Figure 2-1 Output of wwbinfo 


$ wwbinfo 

PROGRAM- FUNCTION TABLE 


On-Line Help with WRITER'S WORKBENCH Programs 

wwbaid describes programs and explains how to use them 

wwbhelp word gives infanratian about programs and functions 

wwbinfo prints this PROGRAM-FUNCTION TABLE 

On-Line Help with Grammar, Spelling, Punctuation, and Usage 

prosestnd prints standards used by prose to evaluate documents 

continrls explains clear ways to present contingencies 

punctrls explains punctuation rules 

spelltell word finds the correct spelling of word 

splitrls explains split infinitives 

tmarkrls explains correct use of trade/service marks 

worduse word explains correct usage of words and phrases 

HIT RETURN TO GO ON 

Programs for Proofreading 
aero file finds acronyms 

consist file runs three consistency checking programs 

tmark file finds inaccurate trade/service marks (uses hmarkdict) 

canscap file Checks for inconsistent capitalization 

canspell file lists words spelled inconsistently (British vs. American) 

proofvi file proofreads text and corrects errors interactively 

(runs spellwwb, punct, double, and diction) 

sexist file finds sexist phrases and suggests changes (uses sexdict) 

switChr file finds words used as both a noun and a verb 

wwb file runs proof r and prose 

proof r file runs five proofreading programs 

spellwwb f ile ... checks spelling (uses spelldict) 
punct file checks punctuation 

double file finds consecutive occurrences of the same word 

diction f ile .... finds awkward phrases, suggests Changes (uses ddict) 
gram file finds split infinitives and wrong articles 
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Figure 2-1 Output of wwbinfo (continued) 


HIT RETURN TO GO ON 

Programs for Style Analysis 

findbe file prints file and highlights all forms of the verb "to be" 

natch sty le-file(s) .. .collates style-file statistics frcm different texts 

morestyle file runs four additional stylistic analyses on text 

abst file evaluates text abstractness 

diversity file measures variety of vocabulary with type/token ratio 

neg file finds negative words, evaluates their overall effect 

topic file reports frequent words to give an idea of the topic 

ora file prints condensed version of text to shew organization 

parts file assigns graimatical parts of speech to words 

reroff file pits irm/nroff macros back in an already formatted text 

syl file counts syllables of each different word in file 

wwb file runs proofr and prose 

prose file gives detailed ccranentary about the style of a file 

style file calculates and sunmarizes style statistics 

HIT RETURN TO GO ON 

Programs to Analyze Procedural Documents 

cantinge file analyzes treatment of contingencies in procedural text 

murky file finds hard-to-understand sentences in procedural text 

Programs to Customize Dictionaries and Standards 

dictadd adds phrases to user's personal dictionaries: 

ddict - personal dictionary of awkward phrases 
sexdict - personal dictionary of sexist terms 
spelldict - personal dictionary of correct spellings 
tmarkdict - personal dictionary of trade/service marks 

spelladd adds words to spelldict dictionary 

mkstand calculates standards for prose from user documents 


Note Indented ccnmands are automatically run by the contend that 
immediately precedes them. Indented commands can be run singly as well. 
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"On-Line Help with WRITER'S WORKBENCH Programs" lists the programs 
that give you supporting information of various kinds, including the 
programs you are exploring in this exercise. 

Many programs allow you to obtain "On-line Help with Grammar, 
Spelling, Punctuation, and Usage." spelltell and worduse (which is used in 
this exercise) are interactive programs that try to provide the correct 
spelling of words and correct usage of words and phrases, respectively. 

The section called "Programs for Proofreading" includes the proofr 
program, which runs five other programs that help you proofread your 
document, and proofvi, which provides the capability to correct errors 
interactively (see Exercise III). 

The programs that fall under the heading "Programs for Style Analysis" 
provide textual analysis and help highlight problem areas. You will be 
using many of these programs in Exercise II. 

"Programs to Analyze Procedural Documents" provide help with text 
that describes a series of steps to be performed. 

The "Programs to Customize Dictionaries and Standards" allow you to 
make the WRITER'S WORKBENCH system more applicable to your needs. 
These programs create the user-specified dictionaries listed in the last 
section of the wwbinfo output. 

wwbhelp 

wwbhelp is another program designed to help you find your way 
around the WRITER'S WORKBENCH system. For example, if you want to 
correct spelling errors in your document, but you do not know what 
programs to use, the wwbhelp command can tell you what programs 
provide help with spelling. Type: 

wwbhelp spell 

In response, you will get a description of the programs that give 
information on spelling. (The output is shown in Figure 2-2.) 
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Figure 2-2 Output of wwbhelp spell 


$ wwbhelp spell 

dictionary, add spelling words to user's spelladd word 

dictadd 

inconsistently spelled, capitalized, trademarked .. consist file 
inconsistent use of British or American spelling . . canspell file 

. .consist file 

misspelling correction spelltell word 

spellwwb file 

misspelling, check spellwwb file 

proof r file 

proofvi file 

wwb file 


phrases, user deletions frcm search dictadd 

spelladd 

spelldict, add phrases to dictadd 

spelladd 

spelling words, add to user's dictionary spelladd word 

dictadd 

spelling, find correct spelltell 


When the prompt "word?" appears, type any more words 
you want information about. 

When you wish to stop, type q. 

word? 


After each topic dealing with spelling, the programs that give 
information on that topic are listed. For example, the last line before the 
instructions on continuing tells you to use spelltell to search for the correct 
spelling of a word. (You will be using the spelltell program in Exercise II.) 

punctrls and splitrls 

As you can tell from their names, punctrls and splitrls print rules on 
punctuation and split infinitives. To try punctrls, type: 

punctrls 

and you should receive the output shown in Figure 2-3. Read it over 
quickly. 
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Figure 2-3 Output of punctrls 


$ punctrls 

1 . Periods and comas always go inside double quote marks . 

EXAMPLE: "I want to go to the fair," he said. 

The only allowable exception is a single character 
in quotes, e.g., use a tilde 

2. Semicolons and colons always go outside double quotes. 

EXAMPLE: He knew what was meant by "hardcopy"; he didn't 
know about "software." 

3. Question marks and exclamation marks go inside or outside 
double quote marks depending an the sentence sense. 

EXAMPLE: "Where are you going?" he asked. 

What is meant by the word "firmware"? 

4. When a quote ends with a question mark that ends a clause 
and a cornua would normally appear at the end of the clause, 
it is standard to leave the ccnra out. (The first example 
sentence under item 3 illustrates this.) 

5. When using single quote narks instead of double quote marks, 
the same rules apply. (Single quotes are considered 
incorrect, except inside a quotation enclosed in double 
quotes . ) 

6. When a sentence is enclosed in parentheses, the period goes 
inside the closing parenthesis. 

EXAMPLE: (This is a sentence.) 

7. If the words inside parentheses do not constitute a sen- 
tence, but are at the end of the sentence, the period goes 
after the closing parenthesis. 

EXAMPLE: This is a sentence (but not this). 
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Figure 2-3 Output of punctrls (continued) 


8. No cccmas, semicolons, or colons should appear before a left 
parenthesis. If such punctuation is needed, it is placed 
after the phrase in parentheses. 

EXAMPLE: After eating salt (sodium chloride), he threw up. 

9. Dashes never occur next to comas, semicolons, blank spaces, 
or parentheses. 

EXAMPLE: Before World War I — but not afterwards — Iceland was 
a part of Denmark. 

The WRITER'S WORKBENCH programs for checking punctuation cannot 
identify complex punctuation problems, such as missing commas. However, 
they do check most of the more mechanical rules listed here. We have 
provided punctrls as an on-line reference you can use if the programs that 
check punctuation list errors you do not understand, punctrls is by no 
means a complete guide to punctuation, but it does explain the rules the 
WRITER'S WORKBENCH system checks as well as some other rules, and it 
may save you a trip to a style manual. 

splitrls works in the same way as punctrls, but it gives you an 
explanation of split infinitives. You can get a copy by typing: 

splitrls 

The output, shown in Figure 2-4, explains what split infinitives are and why 
you should be aware of them. 
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Figure 2-4 Output of splitrls 


$ splitrls 

An infinitive is a verb farm that contains the word "to." 
Examples include: 

1 . to make 

2. to pursue 

3 . to eat 

4. to be going 

An infinitive is said to be split when a word or phrase 
occurs between "to" and the verb. Possible split infinitives 
include : 

1 . to often make 

2. to quickly pursue 

3. to immediately eat 

4. to soon be going 

There is nothing ungrammatical about split infinitives; usu- 
ally, however, they are awkward. If the meaning of the phrase is 
clear without the split infinitive, by all means don't use it. 

There are cases, however, where the meaning is not clear 
unless the infinitive is split. For exanple a and b do not mean 
the same as c. 

a. Really to understand calculus, you nust do the exercises. 

b. To understand calculus really, you must do the exercises. 

c. To really understand calculus, you must do the exercises. 

In such cases, many granmarians will tell you it is accept- 
able to use the split infinitive. It is usually possible, how- 
ever, to change the form of the sentence as in examples d and e, 
and keep sane readers frcm downgrading you. 
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Figure 2-4 Output of splitrls (continued) 


d. Really understanding calculus requires your doing the exer- 
cises . 

e. To understand calculus fully, you must do the exercises. 


worduse 

worduse is another program that gives on-the-spot information to help 
you make decisions about your writing. In response to the system prompt, 
type: 

worduse 

Read the instructions, and at the "word?" prompt, type in the word 
hopefully. You will receive an explanation of the proper use of "hopefully." 
At the end of that output, you will see the prompt "word?" again. This 
time, type which. At the end of that output you will see the prompt 
"word?" again. Type q to quit the worduse program. The output is shown 
in Figure 2-5. 

Figure 2-5 Output of worduse 


$ worduse 

When the pranpt, "word?" appears, type the word/phrase 
you want information about. 

When you wish to stop, type q. 

word? hopefully 

HOPEFULLY: [use properly] HOPEFULLY means "in a hopeful 
manner. " Many people also use HOPEFULLY to mean "it is to be 
hoped." Although sane usage experts grudgingly accept this 
second meaning, many still consider it incorrect. 
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Figure 2-5 Output of worduse (continued) 


In formal writing, use HOPEFULLY only to convey the first 
meaning. 

FAULTY If you look long enough, hopefully you will 
find it. 

CORRECT Hopefully, I continued my search. 


word? which 

THAT: WHICH: [use properly] Use THAT to introduce 
restrictive clauses, WHICH to introduce nonrestrictive 
clauses . 


RESTRIC. The old books that came frcm Europe 
CLAUSE are fascinating. (The restrictive clause 

limits the books being discussed to those 
books that came from Europe . ) 


N3NRESTRIC. The old books, vdiich came frcm Europe, 

CLAUSE are fascinating. (All the bocks being 

discussed are old; the nonrestrictive clause 
simply gives additional information about the 
bocks. ) 


If the clause could contain "by the way," then use WHICH 
with a oatira before it. 

The old books, which by the way came frcm Europe, 
are fascinating. 


WHICH: WHO: THAT: [use properly] Use WHICH to refer to 
nanhumans, WHO to refer to persons, and THAT to refer to 
either. See also THAT, WHICH. 

word? q 
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Exercise II 


In this exercise, you will use the wwb program to analyze a passage 
from "The Gopher and Buried Cable."* We have modified the original text 
by introducing errors for you to find using the WRITER'S WORKBENCH 
system. None of these errors appeared in the published article. 

wwb runs two programs, proofr and prose, which provide proofreading 
and text analysis output. In this exercise, we will go over that output in 
detail. We recommend that you copy the gopher file, as shown below, and 
make the changes as you read the tutorial. 

In Exercise III, the proofvi program is used to analyze the gopher file 
again, proofvi runs spellwwb, punct, double, and diction, and it provides 
interactive error correction through a menu system and a vi-like screen 
editor. For Exercise III, you will have to have a video display terminal to 
use proofvi. 

To make your own copy of the sample text, type: 

cp /usr/lib/wwb/gopher gopher 

If you already have a file called gopher, this command line will overwrite 
it. To check that you have successfully copied the gopher file, type: 

pr — n gopher 

The UNIX system command pr (print) is similar to the cat (concatenate) 
command. Both pr and cat print the contents of a UNIX system file, line by 
line, but pr separates the output into pages and heads each page with the 
date, time, and filename. The original file, however, remains unaltered. 

The — n option used here numbers the lines in the file, making it easy to 
refer to specific lines in the file called gopher. 


* R. A. Connolly, and J. J. Cogelia, "The Gopher and Buried Cable," Bell Laboratories Record, 
April 1970, 99-103. 
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Your output should look like Figure 2-6. Take a minute to read the text. 
You might even circle errors you find and underline sections you think 
have problems. 

Figure 2-6 Output of pr — n gopher 


$ pr -n gopher 

Nov 3 13:29 1984 gopher Page 1 


1 .SA 1 

2 .nr Pt 1 

3 .nr Hy 0 

4 .PH "" 

5 .P 

6 Many biological organisms cause danage to catinunication 

7 wires and cables; bacteria, fungi, insects, rodents, 

8 and marine borers are examples. 

9 However, the most rapid and extensive damage is caused 

10 by various species of rodents. 

11 .P 

12 It is generally recognized that gophers are attracted 

13 to disturbed soil such as that found in an freshly buried 

14 wire and cable trench. 

15 one theory for gopher damage is that the animals believe 

16 the soft lead cables to be roots from which they can expect water. 

17 Generally, however, it is believed that rodents must chew to 

18 keep their incisors sharp and to keep them fran growing too long. 

19 .P 

20 Because of gopher damage experienced an less important 

21 cables the first Bell System coaxial cable was protected by means 

22 of .01-inch steel tapes covered with asbpalt impregnated jute. 

23 This cable was installed between Stevens Point, Minnesota, and 

24 and Minneapolis in 1940. 

25 Gopher damage to the asphalt and jute (which presumably occurred 

26 soon after installation) exposed the steel to the corrosive 

27 enviorment of the soil and eventually resulted in failure of the cable. 

28 Because of this experience, tests with live animals were 

29 conducted by Livingston, to hopefully find vhat thickness of 

30 material would prevent penetration, and in addition be 

31 corrosion resistant. 

32 These tests which used the cables as a barrier indicated that 

33 a .01-inch copper tape was a reasonable choice. 
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Figure 2-6 Output of pr — n gopher (continued) 


34 This material was first utilized an Bell's Dallas - Los Angeles 

35 coaxial toll cable. 

36 .P 

37 Because of the history of damage cited above, the Bell System 

38 has in general applied sane fran of gopher protection to wires and 

39 cables west of the Mississippi River and in sane of the southern states. 

40 Jute or polyethylene-covered thermoplastic-flooded steel has 

41 been utilized for the cables while wire products were protected with 

42 polyvinyl chloride (PVC jacketed galvanized steel. 

How to Run the Basic WRITER’S WORKBENCH System 
Programs 

By using one command, wwb, you can get a wealth of information 
about your document. To run the wwb command on the gopher file, type: 

wwb — u e gopher 

The — u e option means you have asked to compare this text to the standards 
for good educational documents. If all goes well, you will have several 
pages of analysis for the gopher text. Figures 2-7 through 2-12 provide you 
with the results of the analysis. 


A TUTORIAL INTRODUCTION 


2-15 




Figure 2-7 Output of wwb — u e gopher (proofr, Page 1) 


$ wwb — u e gopher 

Mar 26 13:01 1985 proof r —1 gopher Page 1 


****************************** SPELLING ******************************* 
Possible spelling errors in gopher are: 
ashpalt enviarment 

If any of these words are spelled correctly, later type 

spelladd wordl word2 . . . wordn 
to have them added to your spelldict file. 


***************************** HJN2TOATICN ***************************** 
The punctuation in gopher is first described. 

0 double quotes and 0 single quotes 

1 apostrophes 

2 left parentheses and 1 right ones 

Because of the unbalanced parentheses, the following check for mistakes 
may make errors. 

The program next prints any sentence that it thinks is 
incorrectly punctuated and follows it by its correction. 


line 15 

OLD: one theory for gopher damage is that the animals believe 
NEW: One theory for gopher damage is that the animals believe 

For more information about punctuation rules, type: 

punctrls 
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Figure 2-7 Output of wwb — u e gopher (proofr, Page 1 continued) 


***************************** DOUBLE WORDS **************************** 
For file gopher: 

and and appears beginning line 23 

***************************** WORD CHOICE ***************************** 

Sentences with possibly wordy or misused phrases are listed next, 
followed by suggested revisions. 


For file gopher: 
beginning line 19 gopher 

P Because of gopher damage experienced an less important cables 
the first Bell System coaxial cable was protected 
*[ by means]* of . 
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Figure 2-8 Output of wwb — u e gopher (proofr, Page 2) 


Mar 26 13:01 1985 proofr —1 gopher Page 2 

beginning line 28 gopher 

Because of this experience, tests with live animals were conducted 
by Livingston, to *[ hopefully]* find what thickness of material 
would prevent penetration, and in addition be corrosion resistant. 

beginning line 32 gopher 

These tests *[ which ]* used the cables as a barrier 
*[ indicate]*d that a . 

beginning line 34 gopher 

This material was first *[ utiliz]*ed an Bell's Dallas - Los Angeles 
coaxial toll cable. 

beginning line 40 gopher 

Jute or polyethylene-covered thermoplastic-flooded steel has been 
*[ utiliz]*ed for the cables while wire products were protected 
with polyvinyl chloride (PVC jacketed galvanized steel. 

file gopher: number of lines 42 number of phrases found 6 

Please wait for the substitution phrases 


Table of Substitutions 

PHRASE SUBSTITUTION 

by means: use "with, by, through" for "by means of" 
hopefully: use "hopefully means full of hope" for "hopefully" 
indicate: use "show, suggest" for "indicate" 
utiliz: use "use" for "utilize" 

which: use "that" in restrictive clauses for "which" 
which: use "when" for "at which time" 
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Figure 2-8 Output of wwb — u e gopher (proofr. Page 2 continued) 


* Not all the revisions will be appropriate for your document. 

* When there is more than one suggestion for just one bracketed 
word, you will have to choose the case that fits your use. 

* Capitalized words are instructions, not suggestions. 

» lb find out more about each phrase, type "worduse phrase." 

NOTE: If you want this program to look for additional phrases 
or to stop looking for seme, for instance to stop 
flagging "impact," type the ccmrand dictadd. 

******************************* GRAMMAR ************************** 

Possible granmatical errors: 

In gopher: 

article error: "an freshly" should be "a freshly" about line 12 
split infinitive: "to hopefully find" about line 28 
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Figure 2-9 Output of wwb — u e gopher (proofr. Page 3) 


Mar 26 13:01 1985 proofr —1 gopher Page 3 


For information an split infinitives type: 

splitrls 
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Figure 2-10 Output of wwb — u e gopher (prose. Page 1) 


Mar 26 13:02 1985 prose -m m -i g — 1 -u e gopher Page 1 


BECAUSE YOUR TEXT IS SHORT (< 2000 WORDS & < 100 SENTENCES), 
THE EOLLCWING ANALYSIS MAY BE MISLEADING. 

NOTE: Your text is being compared against standards derived 
from 34 good instructional texts. 


READABILITY 

The Kincaid readability formula predicts that your text 
can be read by someone with 14 or mare years of schooling, 
vhich is rather high for this type of document. Good train- 
ing materials average close to the 10th grade level, even 
though the audience has more education than that. 

VARIATION 

Variation in sentence length, type, and openings 
prevents monotony. Mare importantly, a lack of such 
variation suggests that every topic and every sentence has 
equal weight, which makes it difficult for the reader to 
pick out the important points. 

In this text 62% of the sentences are ocmplex and 23% 
are simple. These percentages should be closer together. The 
difference between these percentages , here 39, should be 
less than 28. 

This document contains many more complex sentences than 
is caiman for this type of text. (Complex sentences are 
sentences containing an independent clause [ a sentence] and 
a dependent clause [an incatplete sentence], e.g. , "After 
the rain fell, the plants grew.") One way to improve this 
text then, vrould be to rephrase the most important ideas in 
simple sentences, which will give those ideas additional 
emphasis. 
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Figure 2-10 Output of wwb — u e gopher (prose. Page 1 continued) 


Such changes would also help to reduce the average 
sentence length. This average is 23 words, which is high. 
A good average would be 15 to 20 words. 

SENTENCE STRUCTURE 

Passives 

Thus text contains a much higher percentage of passive 
verbs (36.0%) than is cannon in good documents of this 
type. The score far passive verbs should be below 28.7%. 
A sentence is in the passive voice when its grammatical 
subject is the receiver of the action. 

PASSIVE: The ball was hit by the bey. 

When the doer of the action in a sentence is the subject, 
the sentence is in the active voice. 
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Figure 2-11 Output of wwb -u e gopher (prose. Page 2) 


Mar 26 13:02 1985 prose -m m — i g — 1 — u e gopher Page 2 


ACTIVE: The boy hit the ball. 

The passive voice is sometimes needed 

1. to emphasize the object of the sentence, 

2. to vary the rhythm of the text, or 

3. to avoid naming an unimportant actor. 

EXAMPLE: The appropriations were approved. 

Although passive sentences are sometimes needed, 
psychological research has shown that they are harder to 
comprehend than active sentences. Because of this you 
should transform as many of your passives to actives as 
possible. You can use the style program to find all your 
sentences with passive verbs in them, by typing the 
following command when this program is finished. 

style -p p file 


Verb-Adjective Ratio 

You have a high verb-adjective ratio, which means that 
you have limited your modifiers appropriately. 

Nominal izatians 

You have appropriately limited your ncminalizatians 
(nouns made from verbs, e.g. , "description"). 
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Figure 2-1 1 Output of wwb -u e gopher (prose. Page 2 continued) 


PROSE OOTPOTS 
Options 

You can request that prose use different standards 
when evaluating your document. For example typing "-u t" 
with the prose conmand, e.g., 


prose -u t file 

will canpare your text against technical documents. 

A -s option will provide a very short version of the 
prose output. 


prose — s file 

If you already have a style table in a file, you can 
save time by using it as the input to prose rather than the 
textfile. To do this, precede the style table filename with 
a -f, e.g., 


prose -f style-file 
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Figure 2-12 Output of wwb — u e gopher (prose. Page 3) 


Mar 26 13:02 1985 prose -m m — i g — 1 -u e gopher Page 3 


All the options can be selected at the same time and 
listed in any order. 

prose —f style-file -s -u t 


Statistics 

The table of statistics generated by the program style 
can be found in your file styl.tmp. If you want to lock at 
it type: 


cat styl.tmp 

You can also use the match program, which provides a better 
format , type : 


match styl.tmp 

If you are not interested in the file, remove it by typing: 
rm styl.tmp 


ORGANIZATION 

The prose program cannot check the content or 
organization of your text. One way to lock at the overall 
structure of your text is to use grep to list all the 
headings that were specified far the nm formatter. To do 
this, type: 


grep '~.H' file 

You can also use the organization program, org, to look 
at the structure of your text. It will format your paper 
with all the headings and paragraph divisions intact, but 
will only print the first and last sentence of each 
paragraph in your text so you can Check your flow of ideas. 

org file 
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Overview of the wwb Output 

The first three pages of the wwb output (Figures 2-7 through 2-9) are 
the results of proofr, the five-part proofreading command run by wwb. 
proofr provides spelling, punctuation, double word, word choice (or 
diction), and grammar (incorrect article and split infinitive) information 
about your text. The last three pages of output (Figures 2-10 through 2-12) 
are the result of prose, the other second-level command that analyzes 
stylistic features of text: readability, variation, and sentence structure, 
proofr and prose can be run separately; wwb runs them both. 

Note that both programs date the output, echo the command line you 
used (including the default —1 option), and print the output page number. 
Also note that you now have a file called styl.tmp in your directory. 

In the next few sections, you are going to revise your text based on the 
wwb output. Before you begin, read the contents of styl.tmp. It should 
look like Figure 2-13. 
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Figure 2-13 Output of cat styl.tmp after proofr Revisions to gopher 


$ cat styl.tmp 
readability grades: 

(Kincaid) 13.6 (auto) 14.4 (Coleman-Liau) 13.5 (Flesch) 14.8 (37.9) 
sentence info: 

no. sent 13 no. wds 294 
av sent leng 22.6 av word leng 5.20 
no. questions 0 no. imperatives 0 
no. content wis 180 61.2% av leng 6.57 

short sent (<18) 23% (3) long sent (>33) 8% (1) 

longest sent 36 vris at sent 12; shortest sent 13 wds at sent 7 
sentence types: 

simple 23% (3) oatplex 62% (8) 
compound 8% ( 1 ) ccnpound-ccnplex 8% { 1 ) 
word usage: 

verb types as % of total verbs (32) 
tobe 44% (14) aux 13% (4) inf 13% (4) 
passives as % of non- inf verbs 36% (10) 
types as % of total 

prep 12.6% (37) ccnj 4.4% (13) adv 4.8% (14) 
noun 29.3% (86) adj 17.7% (52) prcn 3.1% (9) 
naturalizations 2 % (7) 
sentence beginnings: 

subject opener: noun (2) pran (0) pos (0) adj (5) art (0) tot 54% 

prep 0% (0) adv 15% (2) 

verb 0% (0) sub_canj 23% (3) canj 0% (0) 

expletives 8% ( 1 ) 

More about the contents of styl.tmp later. As you follow the tutorial, 
you will run programs that will again produce a styl.tmp file, overwriting 
the one you now have. To preserve this first version of styl.tmp, rename 
the file by typing: 

mv styl.tmp styl.tmpl 

Now you can revise the text using the output you got from running 
wwb — u e gopher, or you can use the proofvi program to make the 
corrections interactively, as shown in Exercise III. 
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How to Revise the Text Based on wwb Output 


Spelling 

Start at the beginning of the wwb output shown in Figure 2-7. Spelling 
errors are easy to correct using the spelling programs in the WRITER'S 
WORKBENCH system. In Exercise I you used wwbhelp to find out what 
spelling programs are available in the WRITER'S WORKBENCH system (Figure 
2-2). The wwb command you just ran used the spell wwb program to get 
this list of errors. Now you will be using the spelltell program to help you 
with the corrections. 

Two words are listed as possible spelling errors in gopher: "ashpalt" 
and "enviorment." You probably recognize "ashpalt" as a typographical 
error. It should be "asphalt." Use a UNIX system text editor to correct it. 

The second possible spelling error is "enviorment." If you do not know 
the correct spelling for this word, you can use the spelltell program to 
search for the correct spelling. Type: 

spelltell 

The program responds with "Do you want instructions? (y or n)." When 
you respond y for "yes," the program gives you instructions and then a 
prompt: "word?". After the prompt, type: 

enviorment 

The program lists the correct spelling, "environment." Type q to quit the 
spelltell program. Use a UNIX system text editor to correct "enviorment" in 
the gopher file. 

If you are unsure of the spelling of "incisors" (line 18), even though it is 
not listed as a misspelled word, use spelltell again to find the correct 
spelling. The program can be used in two ways: by typing the command 
alone (as you did in the example above) or by typing, on the same line as 
the command, the word you want to check. Type: 

spelltell incisors 

In response you get "indispose," and if you press the RETURN key, you get 
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"incise" and then "incautious," but not "incisors." It just is not among the 
27,300 words in the spelltell dictionary. You will have to resort to looking 
it up in a dictionary, and you will see that "incisors" is spelled correctly. 
Type q again to quit the program. 

proofr actually uses spell, a UNIX system program, to find misspelled 
words. The spell dictionary contains the word "incisor," which is why it 
wasn't listed as a misspelling. However, the spelltell dictionary, which 
contains possible corrections for misspellings, does not contain the word. 

Before leaving the topic of spelling, we want to make one more point. 
You might have noticed that the word "from" was used in line 38 of the 
original file (Figure 2-6). Obviously, this should be "form." Correct this 
error using a UNIX system text editor. 

spellwwb, and the higher-level programs that run spellwwb, evaluate 
words individually; the programs know nothing about the content of a 
document. Therefore, misspellings and mistypings may not be recognized 
as errors. This type of error is infrequent, but it does occur. What we want 
to stress again is this: The WRITER'S WORKBENCH system is a set of tools. 
The programs are intended to aid people, not replace them. You still need 
to read your final document to examine content and organization. 

Now all the words in gopher are spelled correctly, but the other 
problems need to be corrected. (The programs that analyze the style of a 
document use word endings and a small dictionary of function words to 
identify parts of speech. Misspellings may affect the stylistic analysis.) 

Punctuation 

The wwb program found two punctuation errors in gopher, unbalanced 
parentheses and a lowercase letter starting a sentence. The program cannot 
locate the unbalanced parentheses for you by line number. (It only counts 
them and checks that the sum is an even number.) Use a UNIX system text 
editor to find where the right and left parentheses are and determine how 
to balance them. Solution: The problem is the missing right parenthesis in 
"(PVC" in line 42. 
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The wwb output tells you that the lowercase "o" in line 15 should be 
changed to "O". Make this correction using a UNIX system text editor, too. 
Once you have corrected the punctuation, check to see that there are no 
other problems by running the punct program on gopher. This is the same 
program run by wwb, but here you are accessing it directly. Figure 2-14 
shows the output of punct after the corrections were made. 

Figure 2-14 Output of punct gopher 


$ punct gopher 
punct gopher 

0 double quotes and 0 single quotes 

1 apostrophes 

2 left parentheses and 2 right ones 


no errors found 

Ordinarily, you will not need to run punct again after correcting the errors 
on a first run, but it is wise to reevaluate the punctuation in a passage if 
many corrections are made. 

Before leaving the topic of punctuation, we would like to remind you 
about the punctrls program (Exercise I). You can use it if you do not 
understand why a particular punctuation error was pointed out by the 
WRITER'S WORKBENCH system. 

Double Words 

The wwb program identified the double words "and and" beginning on 
line 23 of the gopher file. Use a UNIX system text editor to check lines 23 
and 24 of gopher. You will see that the "and" at the end of line 23 is 
repeated at the beginning of line 24. Delete one of these words. Then 
check gopher again using the double command directly. Type: 

double gopher 

You should get a short message that says, "No double words found in 
gopher." Usually you will not need to run double again after you have 
eliminated unnecessary double words. Here we have asked you to run it to 
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show that the program can be used individually as well as part of proofr or 
wwb. 

Word Choice 

The next problems wwb found in gopher are possibly wordy or misused 
phrases, wwb uses the diction program to locate these errors. This section 
begins at the bottom of the first page of the wwb output (Figure 2-7). Each 
possible error is printed inside asterisks and brackets, *[ ]*. The 
surrounding text is also printed, in addition to the number of the line on 
which the sentence begins. 

When you revise text, you must carefully consider each of the potential 
word choice errors. The computer does not know the meaning of your text 
and cannot determine how these words and phrases are used. The program 
only searches for what it knows are potential problems. Usually the words 
and phrases it finds can be revised to make the meaning of the sentence 
clearer or less wordy. 

Look at the first sentence in the section on word choice. It shows a 
wordy phrase, "by means of," in the sentence. It also gives you three 
incorrect pieces of information: 

■ It tells you the sentence starts on line 19, but it actually starts on line 20. 

■ It tells you the sentence starts with "P Because of gopher damage ...," but 
the "P" is actually part of the ”.P" macro on line 19. 

• It tells you the sentence ends with "by means of but the sentence 
actually concludes "... by means of .01-inch steel tapes covered with 
asphalt impregnated jute." 

Errors of these three types occur occasionally in the word-choice section; 
they are caused by the method used in the diction program to identify 
sentence boundaries. Very simply, diction looks for and considers each 
one it finds to be the end of a sentence. In this example, starting on line 19, 
it reads ".P" as a period, followed by a new sentence beginning "P Because 
...," and it reads all text until the next (the one in ", 01-inch") as part of 
that sentence. 


A TUTORIAL INTRODUCTION 2-31 



We point this out for two reasons. First, so you understand why the 
output looks that way. Second, and most important, we want to stress that 
this does not affect the validity of the search for wordy phrases. In diction, 
the purpose of printing the line number and the text surrounding the 
wordy phrase is to help you find the wordy phrase in your document. It is 
constructed to do that and nothing more. When accurate identification of 
sentence boundaries is critical (in the style, punct, and prose programs), a 
different, much more precise method is used. 

Read the text that surrounds the potentially wordy phrase. Look up the 
word in the Table of Substitutions, which is on Page 2 of the proofr output 
(Figure 2-8). Then choose the substitution that best clarifies the meaning 
you intended. Usually you will find an appropriate substitution. 

To revise the sentence that begins on line 20, you can substitute "by" for 
the phrase "by means of." The result "... cable was protected by .01-inch 
steel tapes ..." is less wordy, more direct, and sounds better. Similarly, 
"utilized" in the sentences that begin on lines 34 and 40 can be simplified by 
substituting "used." 

For the word "hopefully" (line 29), use worduse to learn why it is being 
flagged by diction. You can also use worduse to see if "which" has been 
misused in the sentence that begins on line 32. (Refer to Exercise I for a 
sample session using worduse with "hopefully" and "which.") 

worduse advises not to use "hopefully” as it is used in the gopher text. 
After reading the first section worduse prints about "which" (explaining the 
proper use of "which" and "that" in restrictive and nonrestrictive clauses), it 
is clear that this use of "which" is appropriate. However, there should be 
commas surrounding the nonrestrictive clause: "These tests, which used the 
cables as barriers, indicated that ...." 

In the same sentence, the word "indicated" is bracketed. The Table of 
Substitutions shown in Figure 2-8 suggests you use "show" or "suggest." 
Perhaps you prefer "indicate" over either of these substitutions. Often in 
scientific material the word "indicate" connotes a sense of exactness, instead 
of just suggestion. This, we believe, is one of those cases. Leave "indicated" 
in the sentence. 
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To summarize the word choice, or diction, revisions for gopher, use a 
UNIX system text editor to change "by means of" to "by" and to change the 
occurrences of "utilized" to "used." Next, delete the word "hopefully," and 
put commas around the nonrestrictive clause containing "which." Do not, 
however, change "indicated." 

Grammar 

The section on grammar shows that the gram program, the fifth 
program run by proofr, found one article error and one split infinitive 
(Figure 2-9). Use a UNIX system editor to change "an freshly" to "a freshly" 
on line 13. 

The word "hopefully" in the split infinitive, "to hopefully find," was also 
identified as a frequently misused phrase in the word choice section. You 
should have eliminated it in your revisions of the wordy phrases. "To find" 
expresses the meaning well enough. So, in revising wordy phrases, you 
also eliminated the split infinitive. 

However, before we leave split infinitives, are you sure you know what 
they are and why they can be a problem? Remember, you can use the 
program splitrls (see Exercise I) to get an explanation of split infinitives. 

Readability, Variation, and Sentence Structure 

You have just finished revising the gopher text based on the results of 
wwb's first major program, proofr, which pointed out several proofreading 
and word choice, or diction, errors. Now you are ready to revise the style 
of gopher to make it more readable. 

The output of wwb's second major program, prose, which analyzes 
stylistic features of text, begins with Figure 2-10. The stylistic features of 
gopher are calculated by several programs that we will discuss later. As 
part of the wwb output, you not only get the values of style characteristics, 
such as a reading grade level of 14, but also the interpretation of such 
values. For example, when you typed the original command (wwb — u e 
gopher), the — u e option caused the gopher passage to be compared to 
educational documents, documents that are used for instruction. You could 
have asked for a comparison with technical documents, — u t, but that would 
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have been inappropriate for the gopher passage. 

You can see in Figure 2-10 that: 

• The reading grade level of gopher is high. 

= It has more complex sentences than is common. 

• It has more passive sentences than is common in good educational 
documents. 

• The average sentence length is high. 

Some of the complex sentences should be simplified to introduce variety 
and reduce the average sentence length. It is likely that sentences in the 
gopher text with a high reading grade level will also contain one or more of 
the other problems style pointed out. (style is one of the programs run by 
prose). Find all the sentences that have a reading grade level higher than 
12. Type: 

style — R 12 gopher 

The style program analyzes each sentence of the input text individually, 
providing some of the raw information used by wwb. With the — R 12 
option, you are asking for the table of statistics style has computed for 
gopher and a list of all sentences that have a reading grade level higher 
than 12. Such sentences will probably also be complex sentences that can 
be changed to simple sentences. Using the style output (Figure 2-15), you 
see seven sentences with reading grade levels higher than 12. 
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Figure 2-15 Output of style — R 12 gopher 


$ style -R 12 gopher 
style -m m — i g -R 12 gopher 

many biological organisms cause damage to *catimunicatian* wires and cables 
; bacteria , fungi , insects , rodents , and 
marine borers are examples . 

sentence length: 19 (impound readability 16.83 : begins with adjective 

it is generally recognized that gophers are attracted to disturbed 
soil such as that found in a freshly buried wire 
and cable trench . 

sentence length: 23 COMPLEX : expletive :: passive: readability 12.60 : begins with expletive 

because of gopher damage experienced an less important cables the 
first Bell System coaxial cable was protected by steel tapes 
covered with asphalt impregnated jute . 

sentence length: 25 OOMPLEX .-passive: readability 17.45 : begins with subordinate conjunction 

gopher damage to the asphalt and jute ( which presumably 
occurred soon after *installatian* ) exposed the steel to the 
corrosive environment of the soil and eventually resulted in failure 
of the cable . 

sentence length: 31 ccmpxind-ccmplex readability 18.99 : begins with noun 

because of this experience , tests with live animals were 
conducted by Livingston , to find vhat thickness of material 
would prevent *penetratian* , and in *additian* be *corrosion* resistant 
sentence length: 27 COMPLEX :passive: readability 18.76 : begins with subordinate conjunction 

because of the history of danage cited above , the 
Bell System has in general applied sane form of gopher 
♦protection* to wires and cables west of the Mississippi River 
and in sane of the southern states . 

sentence length: 36 COMPLEX readability 18.03 : begins with subordinate conjunction 

jute or polyethylene-covered thermoplastic-flooded steel has been used for the 
cables while wire products were protected with polyvinyl chloride ( 
pvc ) jacketed galvanized steel . 

sentence length: 23 COMPLEX :passive: readability 21.20 : begins with noun 
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Figure 2-15 Output of style — R 12 gopher (continued) 


readability grades: 

(Kincaid) 13.3 (auto) 14.1 (Coleman-Liau) 13.4 (Flesch) 14.6 (39.2) 
sentence info: 

no. sent 13 no. wds 288 
av sent leng 22.2 av word leng 5.18 
no. questions 0 no. imperatives 0 
no. content vrfs 177 61.5% av leng 6.54 
short sent ( <17 ) 23% (3) long sent (>32) 8% (1) 

longest sent 36 wds at sent 12; shortest sent 12 wls at sent 7 
sentence types: 

simple 23% (3) ccrrplex 62% (8) 
ccrrpound 8% ( 1 ) corrpound-ccrrplex 8% ( 1 ) 
word usage: 

verb types as % of total verbs (29) 
tbbe 48% (14) aux 14% (4) inf 14% (4) 
passives as % of non- inf verbs 40% (10) 
types as % of total 

prep 12.8% (37) canj 4.2% (12) adv 4.2% (12) 
noun 29.5% (85) adj 19.1% (55) pron 2.8% (8) 
ncminalizatians 2 % (6) 
sentence beginnings: 

subject opener: noun (2) pran (0) pos (0) adj (5) art (0) tot 54% 
prep 0% (0) adv 15% (2) 

verb 0% (0) sub canj 23% (3) oanj 0% (0) 
expletives 8% ( 1 ) 

These sentences are good candidates for revision. Use a UNIX system text 
editor to make the following revisions to the gopher file as they are 
discussed. 

The second sentence listed, "it is generally ...," is a complex sentence; it 
is also passive. You can reduce the length of the sentence and change the 
passive form to active by saying, "Disturbed soil, such as that found in a 
freshly buried wire and cable trench, attracts gophers." This version is less 
wordy, more direct, and more readable. 

The fourth sentence listed in the style output, "gopher damage ...," is a 
compound-complex sentence, and it is 31 words long. (The word 
surrounded by asterisks, " * ", is a nominalization.) You can improve this 
sentence by breaking it into two sentences: "Gopher damage to the asphalt 
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and jute (which presumably occurred soon after installation) exposed the 
steel to the corrosive environment of the soil. Eventually this caused the 
cable to fail." It is now a complex sentence, balanced by a short, simple 
sentence. 

The fifth sentence in the style output begins, "because of this 
experience, ...." It is a complex passive sentence. Break this sentence into 
two to reduce the length and make the text more readable. Also change it 
from passive to active form: "Because of this experience, Livingston 
conducted tests with live animals. Livingston wanted to find what 
thickness of material would prevent penetration and, in addition, resist 
corrosion." Although both of these sentences are still complex, they are 
shorter. Also, both sentences are now active rather than passive. 

The next sentence in the output begins, "because of the history of 
damage cited above, ...." This sentence is complex and contains 36 words. 
Eliminate the redundant introductory phrase to reduce the length and give 
the sentence a simple structure: "The Bell System has in general applied 
some form of gopher protection to wires and cables west of the Mississippi 
River and in some of the southern states." 

The last sentence in the output, "jute or polyethylene-covered ..." is a 
complex sentence with passive verbs. Break the sentence into two short, 
simple sentences: "Jute or polyethylene-covered thermoplastic-flooded steel 
has been used for the cables. In addition, polyvinyl chloride (PVC) jacketed 
with galvanized steel protects wire products." The first sentence, however, 
is still passive. 

You have not eliminated all complex sentences, nor have you changed 
all sentences with passive voice to active voice. You have, however, revised 
five of the seven sentences. You reduced the length of each and modified 
either the complex structure or passive voice of each. Naturally, these are 
not the only revisions you could have made to this text. However, they 
illustrate one approach to making the text more readable. 

Now that you have made these revisions, check the stylistic features 
again. This time you will use the short (— s) form of the prose program. 


A TUTORIAL INTRODUCTION 2-37 


Again, compare gopher to the standards for educational documents, as 
shown in Figure 2-16. 

Figure 2-16 Output of prose — u e gopher 


$ prose —s -u e gopher 
prose — s -m m — i g — u e gopher 

BECAUSE TOUR TEXT IS SBDRT (< 2000 WCRDS & < 100 SENTENCES) , 

THE EOLLCWING ANALYSIS MAY BE MISLEADING. 

Canpared to educational material. 

Reading grade level — 11.3: Good 
Variation — Good sentence type distribution . 

Passives — 25.0%: Good 
Verb-Adjective Ratio — 0.56: Good 
Ncminalizaticns — 3.0%: Good 
Don't forget the styl.tmp file. 

You can see that by revising those five sentences you have made the text 
more readable. The proportion of passive sentences is now within the 
acceptable range. In addition, sentence structure is varied and the problem 
with long sentences has been corrected. 

Finally, look at the values for each of the style characteristics calculated 
by the prose program. You ran the style program earlier to find all 
sentences with reading grade scores higher than 12. (The output is in 
Figure 2-15.) style is the program that calculates values for each of the 
stylistic features of your text. Look at the output in Figure 2-10. These are 
the values for the gopher passage before you revised those five sentences, 
style, which is run automatically by the prose program, calculated these 
statistics and printed them for you to see, but it did not save them 
anywhere for you. However, you will recall that both prose and wwb run 
the style program automatically and then translate the statistics it produces 
into a plain-English discussion of the stylistic features of your text. When 
Style is run by wwb and prose in this way, the style table it creates is saved 
for you, in a file named styl.tmp. 
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Your recent use of the command prose — s — u e gopher (the revised 
gopher file) created a new styl.tmp file in your directory. It contains the 
values that style calculated for your revised version of gopher. You can 
look at styl.tmp by typing: 

cat styl.tmp 

Your output should look like that in Figure 2-17. 

Figure 2-17 Output of cat styl.tmp after prose Revisions to gopher 


$ cat styl.tmp 
readability grades: 

(Kincaid) 11.3 (auto) 11.8 (Colanan-Liau) 13.4 (Flesch) 13.8 (44.4) 
sentence info: 

no. sent 16 no. wds 271 
av sent leng 16.9 av word leng 5.25 
no. questions 0 no. imperatives 0 
no. content wds 174 64.2% av leng 6.51 
short sent (<12) 25% (4) long sent (>27) 6% (1) 

longest sent 28 vris at sent 14; shortest sent 7 wds at sent 9 
sentence types: 

simple 44% (7) complex 38% (6) 
compound 6% (1) ccnpound-oaiplex 13% (2) 
word usage: 

verb types as % of total verbs (29) 
tabe 34% (10) aux 14% (4) inf 17% (5) 
passives as % of ncn-inf verbs 25% (6) 
types as % of total 

prep 11.4% (31) ocnj 4.1% (11) adv 3.7% (10) 
noun 32.1% (87) adj 19.2% (52) prcn 3.0% (8) 
noninalizaticns 3 % (7) 
sentence beginnings: 

subject opener: noun (3) prcn (0) pos (0) adj (6) art (1) tot 63% 

prep 6% (1) adv 19% (3) 

verb 0% (0) sub_canj 13% (2) canj 0% (0) 

expletives 0% (0) 

Note the differences in reading grade levels, number of sentences, and 
sentence types as contrasted with the style information shown in Figure 2- 
13. 
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Remember that the styl.tmp file is overwritten with new values each 
time you run wwb or prose. To save the values from your current analysis, 
you must rename the styl.tmp file before you next run wwb or prose. You 
can use the mv command again to move the contents of styl.tmp to a file 
with a different name. Type: 

mv styl.tmp styl.tmp2 

Now the values for the revised text are stored in a file named styl.tmp2. 

More Comparisons 

The output of the proofr component of wwb is always the same 
whether you compare your document to educational standards (— u e) or to 
technical documents (— u t, the default comparison). A punctuation error is 
always a punctuation error, regardless of the audience. You can, however, 
choose the standards for comparison used in the prose component of wwb. 
For some documents, the appropriate reading level may be between 9 and 
12, as it is for educational documents. For other documents, such as 
technical documents, the appropriate reading level is between 10 and 15. 
Look at the acceptable ranges for educational documents using prosestnd as 
shown in Figure 2-18. 
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Figure 2-18 Output of prosestnd — u e 


$ prosestnd -u e 
prosestnd — u e 

These are desirable ranges for educational documents derived 


frccn 34 good instructional texts: 

Kincaid readability grades: >7.8 to 12.4 years 

Average sentence length: 12.3 to 20.2 words 

Average length of content words : 5.5 to 6.8 letters 

Percentage of short sentences: 23.1% to 31.4% 

Percentage of long sentences : 7.3% to 12.8% 

Percentage of simple sentences minus 

the percentage of canplex sentences : -28 .4% to 56.0% 

Percentage of compound sentences plus 

the percentage of ccitipound-ccrrplex sentences : . . 4 . 7% to 25 . 7% 

Passives should be fewer than: 28.7% 

Verb-adjective ratio should be higher than: 0.35 

Ncndnalizatians should be fewer than: 3.4% 

Expletives should be fewer than 7.2% 


Now look at Figure 2-19 to see the acceptable ranges for technical 
documents. 
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Figure 2-19 Output of prosestnd — u t 


$ prosestnd -u t 
prosestnd -u t 

These are desirable ranges for technical documents based 
an 30 technical documents judged good by technical managers : 


Kincaid readability grades: >10.1 to 15.0 years 

Average sentence length: 16.7 to 25.3 words 

Average length of content words : 5.8 to 7.0 letters 

Percentage of short sentences : 29 . 2% to 38 . 0% 

Percentage of long sentences: 11.7% to 18.9% 

Percentage of simple sentences minus 

the percentage of carplex sentences : -24 .2% to 30.1% 


Percentage of compound sentences plus 

the percentage of coipound-cccnplex sentences:.. 5.7% to 35.2% 


Passives should be fewer than: 28.6% 

Verb-adjective ratio should be higher than: 0.35 

Naninalizatians should be fewer than: 4.2% 

Expletives should be fewer than 5.7% 


Compare the acceptable ranges for these two types of documents. Note 
how different the acceptable ranges for these reading grade levels are. 

If you produce documents that are neither technical nor educational 
documents, you can create your own set of standards from your own good 
examples. If you want to know more about setting your own standards, see 
the description for mkstand in Chapter 3. 

How would the prose evaluation change if gopher were compared to 
the standards for technical documents? You have saved the revised gopher 
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style values in a file called styl.tmp2. You can use that file now. Type: 

prose — s — u t — f styl.tmp2 

The — s option will give you the short version of prose. (You saw the long 
version as part of the wwb output.) The — u t option compares the values 
for gopher to standards for technical documents. The — f styl.tmp2 portion 
of the command line tells the program to take the styl.tmp2 file and use it 
as input instead of computing the values over again. The output for this 
command is shown in Figure 2-20. 

Figure 2-20 Output of prose — s — u t — f styl.tmp2 


$ prose — s -u t — f styl.tnp2 
prose -s-mm— ig-ut-f styl.trrp2 

BECAUSE YCWR TEXT IS SHORT (< 2000 WORDS & < 100 SENTENCES), 
THE POLLCWING ANALYSIS MAY BE MISLEADING. 

Compared to technical papers. 

Reading grade level — 11.3: Good 
Variation — Good sentence type distribution. 

Passives — 25.0%: Good 
Verb-Adjective Ratio — 0.56: Good 
Naninalizatians — 3.0%: Good 


As you can see, the stylistic values of the revised gopher passage are all 
within range for technical documents, too. This comes as no surprise since 
the technical documents have higher acceptable values for most style 
features. For analyzing your own documents, use the standards you feel are 
most appropriate. For general interoffice memos, the educational standards 
will work well. 
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A Final Word on Exercises I and II 


In these first two exercises you have used several WRITER'S WORKBENCH 
system commands. Look back at the output of wwbinfo in Figure 2-1. 

Check off those commands that you have used so far. Remember that when 
you ran the top-level program, wwb, it also ran several lower-level 
commands. 
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Exercise III 


proofvi is an interactive proofreading program, named for its 
combination of the proofr program with a vi-like interface for corrections. 
This combination allows you to identify and correct proofreading errors 
within one program. To identify errors, proofvi runs four other programs: 

■ spellwwb checks for misspelled words. 

■ punct checks for punctuation errors. 

■ double searches for consecutive occurrences of the same word. 

■ diction locates wordy or misused phrases and suggests substitutions. 

In this exercise, you will learn how to correct the errors proofvi finds in 
your file by using a combination of the program's menu system to make 
changes automatically and the vi-like screen editor to change text 
interactively. To see the command line synopsis for proofvi, refer to the 
manual page in Chapter 3 or type: 

man proofvi 

(Note that manual pages are available on the 3B5 and 3B20 Computers, but 
not on the 3B2 Computer.) 
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How proofvi Works 


proofvi runs in two stages. First it runs in the background to find and 
store proofreading errors in a file called a reference file (in the following 
examples, ref. file). When done, proofvi sends you mail that you can run 
the second stage to edit your file. By default, each stage is invoked 
separately. You can invoke both stages at once (with the — e option), but 
this ties up your terminal while stage one is running. The two stages are 
described below. 

1. When proofvi is first called with a text file as input (by typing proofvi 

file), it does the following in background processes: 

■ Finds proofreading errors in file by running four proofreading 
programs: spellwwb, punct, double, and diction. 

• Stores information about the errors in a reference file named ref. file 
(where file is the name of your input file). 

■ Sends you mail when it is finished finding and storing the errors. 

The mail message names the input file and the newly created 
reference file (ref. file) and tells you to type proofvi file to correct the 
errors. 

2. When proofvi is invoked for the second, interactive stage with the 

command proofvi file, it does the following: 

• Displays the input file, one screen at a time, with proofreading errors 
highlighted. 

■ Provides menus that describe the current error, suggest changes, and 
offer command choices to correct that error. 

• Allows you to make corrections to the error automatically with the 
menu choices. 

■ Provides a subset of vi commands for you to make your own 
corrections. 

■ Provides help information for vi commands. 
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Provides you with the ability to tailor your personal diction and 
spellwwb dictionaries. 

Updates and saves the reference file of remaining errors if you want 
to quit editing before seeing all the errors. You can then reinvoke 
proofvi file at a later time, without having to wait for proofvi to run 
the proofreading programs (stage one) again. 
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How to Use proofvi 


This section describes how to use proofvi, specifically: 

. How to start the session. 

• How the screen looks to you when using proofvi interactively. 

• How to use the menus. 

• How to end your session. 

Starting and Stopping the Session 

In this exercise, you will use the sample file, gopher, with which you 
worked in Exercise II. As a result, you will have to recopy gopher from the 
wwb source directory to see the original errors. If you do not want to 
overwrite the corrected version of gopher that you used in the earlier 
exercise, you can either change the name of the corrected version (for 
example, cp gopher correct.gopher) or work in a different directory. Type: 

cp /usr/lib/wwb/gopher gopher 

In addition, check your .profile to ensure that the MAIL variable is set to 
the file name to which mail is sent, usually /usr /mail / login-name, so that 
you will receive your mail messages. Also check that TERM is set to your 
terminal type and exported. 

Now type: 

proofvi gopher 

You will get the following message: 
proofvi gopher 

The prcofvi program is new looking for errors in your file gopher; it will 
send you mail when it is finished. Whit until you get the mail to continue. 

The UNIX system prompt will reappear, but proofvi will continue to run in 
the background to find proofreading errors in the gopher file. You are free 
to do other things at your terminal while you wait for proofvi to complete 
its processing. With a short file like gopher, the mail message should take 1 
to 2 minutes to appear. 
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When proofvi is done, you will receive the following mail message: 

Your reference file, ref . gopher , has been completed. 

To run the interactive part of proofvi now, 
exit the mil program and type 
proofvi gopher 

The file ref.gopher, created by proofvi, lists the line and column numbers 
of all the errors found in the gopher file, proofvi uses it during the editing 
session, but you do not have to do anything with it. 

Type: 

proofvi gopher 

In response, you will see the first screen (Figure 2-21) showing the errors 
that proofvi found in your file. If your first screen is not the same (for 
example, a different number of errors), you may have words in your 
personal dictionaries that proofvi no longer finds as errors, or additional 
words that proofvi finds as errors. 

You can stop the editing session at any time (except when you are in 
the spelling corrector menu) by typing :wq, ZZ, or :q! (see Ending the 
Session). Your original file and your ref. file will be updated to reflect the 
changes that you have made during the editing session if you quit using 
:wq or ZZ. Your original file will remain untouched if you quit using :q!. 

If you have made changes and you type :q!, your ref .file will be removed. 

Looking at the Screen 

For the file gopher, this is the first screen that you will see: 
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Figure 2-21 Output of Punctuation Menu 


Many biological organisms cause damage to cannunication 
wires and cables; bacteria, fungi, insects, rodents, 
and marine borers are examples. 

However, the most rapid and extensive damage is caused 
by various species of rodents. 

.P 

It is generally recognized that gophers are attracted 
to disturbed soil such as that found in an freshly buried 
wire and cable trench. 

_[_o J ne theory for gopher danage is that the aninals believe 
the soft lead cables to be roots from which they can expect water. 

Generally, however, it is believed that rodents must chew to 
keep their incisors sharp and to keep than from growing too long. 

.P 

Because of gopher damage experienced an less important 

cables the first Bell System coaxial cable was protected j_by_means_j 

of .01-inch steel tapes oovered with j ashpalt_j impregnated jute. 

The first word of a sentence should be capitalized. 

:i Ignore this error type for rest of file. 

:p Program makes suggested change. 

Ctrl-N Go to next error. PUNCTUATION 

file gopher; 10 items found; 10 remaining 0orrect=O 

proofvi splits the screen into three sections: the text, a menu, and a 
line at the bottom of the screen where the initial number of errors appears. 
As you begin to work, colon commands that you enter and error messages 
that you receive will also appear on this bottom line. 

In Figure 2-21, the errors found by proofvi are shown in boxes in the 
text section. Depending on the capabilities of your terminal, the errors may 
be shown in boxes, underlined, shown in reverse video, or not indicated at 
all, and the first error may be flashing. The cursor (possibly blinking) will 
be on the first character of the first error. 

Using the Punctuation Menu 

As you can see, the first 17 lines on the screen are text from your 
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gopher file, which is separated from the menu section by a line of dashes. 

In the text section of your screen, the cursor falls on the letter V of the 
word "one." In the menu section, the first line of text states the punctuation 
rule that was broken by the small letter "o" at the beginning of the sentence, 
"one theory for gopher damage ...." The menu title, PUNCTUATION, is 
shown in the lower right corner of the menu section. The phrase, 
Correct=0, is on the right side of the bottom line of the screen. This phrase 
tells you how the punct program will correct the error if you choose to 
accept proofvi's suggestion. Here, the punct program will capitalize the "o" 
in the word "one." 

The second two lines in the menu 

:i Ignore this error type for rest of file. 

:p Program makes suggested change. 

list the available commands in the Punctuation menu, :i and :p. Notice that 
the colon is part of the command. It causes the cursor to move to the 
bottom line of the screen where you can type in your command choice. A 
brief explanation appears next to each command in the menus. All colon 
commands must be followed by a RETURN. 

To correct the first error using the change punct has suggested, type: 

: P 

The program automatically makes the recommended change: 
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Figure 2-22 Output of :p 


wire and cable trench. 

One theory for gopher damage is that the animals believe 

the soft lead cables to be roots frccn which they can expect water. 


The first word of a sentence should be capitalized. 

:i Ignore this error type for rest of file. 

:p Program makes suggested change. 

Ctrl-N Go to next error. HJNCIUATTON 

=P 


punct Summary 

In summary, the Punctuation menu displays both the violated 
punctuation rule and the correction, and it allows you to use the following 
commands, which you will learn more about as you go through the tutorial. 

1. Ignore reports of the same error type during the rest of the editing 
session (:i). 

2. Correct the error automatically (:p). 

3. Correct the error yourself (using vi commands). 

4. Go to the next error (Ctrl-N). 

5. Get help with vi commands (:h), although this option is not shown on 
the menu. 

6. Stop the editing session at any time (:wq, ZZ, :q!). 

Handling Errors 

There are several types of errors that you might make as you enter 
commands. You can correct most of these errors by reentering the correct 
command when prompted by the error message that appears on the bottom 
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line of the screen. Type: 


You will receive the message: 

You haven't specified anything for the ; to represent 

Now type: 

:z 

When you enter a command that is not listed on any menu, the program 
rings the terminal bell and returns the error message: 

This is not an option to proofvi. 

Type: 


:a 

When you enter a command letter recognized by another menu, the 
message is: 

:a is only for diction or spelling errors. 

Using the Diction Menu 

Now that you have corrected the first error, type 

Ctrl-N 

(N stands for next) by holding the CONTROL key and typing n at the same 
time. The cursor will go to the next error, the phrase "by means," and the 
following Diction menu will appear under the text: 
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Figure 2-23 Output of Diction Menu 


Because of gopher damage experienced an less important 

cables the first Bell System coaxial cable was protected _[_by_means_J 

of .01 -inch steel tapes covered with _[_ashpalt3J impregnated jute. 


:s Show substitutions for phrase. :a Add to personal dictionary to suppress. 
:i Ignore error for rest of file. :h Help with vi contends . 


Ctrl-N Go to next error. 


DICTION 
by means 


The format of the Diction menu is similar to the Punctuation menu. 

You have a choice of commands, including the option to change nothing 
and go on to the next error. Below the menu title, DICTION, in the lower 
right corner, proofvi prints the phrase from the text, not a suggested 
correction as it does in the Punctuation menu. All the menus, except 
Punctuation, print the word or phrase that the proofreading programs have 
found under the menu title. This feature helps you to locate the error when 
your terminal does not have highlighting capabilities. 

diction locates sentences in a document that contain incorrect or wordy 
phrases and suggests possible substitutions. However, diction does not 
consider the context of the phrase; it only searches for fixed patterns. There 
are usually so many ways a phrase can be used that you must determine 
which suggestion, if any, is appropriate in each case. 

Now, type the command 


:s 

to see diction's suggested substitutions. The following menu will appear: 
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Figure 2-24 Output of :s 


Use for by means of: with, by, through 


Ctrl-N Go to next error. 


:b Back to Diction menu. 


Although the original Diction menu highlighted the phrase "by means," 
the questionable wording is "by means of." diction saves storage space in its 
dictionary by flagging "by means," but then prints the complete phrase in 
the :s output. 

The program offers three substitute phrases: "with," "by," or "through.” 
You can use one of these suggestions, use one of your own, or ignore the 
error (by typing Ctrl-N). If you decide to change "by means of" to some 
other word or phrase, you must use the vi editor commands (see Summary 
of Commands). If you want help with vi commands, you can use the :h 
(help) command. Although the :h command does not appear on all the 
menus, you can enter it in any menu (except the spelling corrector) to access 
information about vi commands. 

Type 

:h 

and the following screens will appear: 
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Figure 2-25 Output of :h 


The proofvi program uses a restricted subset of the vi commands. 
Experienced vi users should edit as they would nontally. The program will 
let you know whenever you try to use a oatitand that it doesn't know. 

For users new to vi, the following is a brief description 
of the most ccmmon editing ccrtrrands . 

WRITE/ QUIT — :w, :wq, ani :ql. :w writes out intermediate changes. :wg quits, 
saving changes; :ql quits, throwing away changes. 


CHAN3ES — the c ccrmand 

Most Changes begin at the cursor and stop at a location specified by you. 
The ending location is highlighted by a $. Once you've typed the ccmnand, you 
then type in your new text and terminate it with the escape key. 

To Change a word, type <cw>, to change 2 words type <c2w>. To Change to 
the end of the line, type <c$>; to change the entire line, type <cc>. 

DELETIONS — the d command 

Deletions work the same way as changes. Thus you can have <dw>, <d2w>, 
<d$>, and <dd>. Since delete commands do not put you in input mode you do 
not need to terminate them with the escape key. 

MOVE CURSOR 

To move by a word, type <w>, by one character, < >, to the end of the 
line, <$>, to the beginning <~>. To move up one line, use <->, to move 
down one line use <carriage returns-. To move up two lines, use <2->. 

INSERT/APPEND — i and a ccrrmands 

To insert Characters before the cursor, type <i>, to append after the 
cursor, type <a>. Both must be terminated by the escape key. 

CREATE A NEW LINE — 0 and o ccrtnands 

To create a blank line above the cursor, type <0>; below the cursor, type 
<o>. You will then be in insert mode and must terminate it with the escape key. 

UNDO — U and u catmands 

The U ccnmand will set the current line back to its state when the cursor 
first moved to it. The u ccrmand will undo the very last Change you made. 

SHELL ESCAPE—: !sh 

To escape to the shell type < : I sh> . When you have completed your other 
work, type <Ctrl-D> to come back to proofvi. 
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Because some screens cannot show highlighting or characters in bold, the :h 
screens show commands you type in angle brackets (<>). These angle 
bracket characters are not typed when you enter the command. 

The program shows you the :h screens and tells you to press RETURN to 
return to the Diction menu. Now, with the cursor on the letter "b" in the 
word "by,” type 

d2w 


or 


2dw 

to delete the words "by means.” Because the vi delete commands will not 
work across line boundaries in proofvi, you still have to eliminate the word 
"of" on the next line. You can do this by using RETURN to move down to 
the beginning of the next line and typing 

dw 

to delete "of." 

Next type: 


(i stands for insert). The cursor will not move, but you will be in insert 
mode and the words INPUT MODE will appear in the lower right corner. 
Type 

with 

and press 

SPACE BAR 
and then press 

ESCAPE 

to get out of insert mode. At that time, the words INPUT MODE will 
disappear from the lower right corner. You will see other diction options 
later in the exercise. 
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Type 


Ctrl-N 

to move the cursor to the next error, "ashpalt." 

Making Other Changes Not Marked by proofvi 

Now that you haved moved to the next error, the following screen will 
appear: 

Figure 2-26 Output of Spelling Menu 


to disturbed soil such as that found in an freshly buried 
wire and cable trench. 

One theory for gopher damage is that the animals believe 
the soft lead cables to be roots frcm which they can expect water. 
Generally, however, it is believed that rodents must chew to 
keep their incisors sharp and to keep them from growing too long. 

• P 

Because of gopher damage experienced cm less important 

cables the first Bell System coaxial cable was protected 

with .01-inch steel tapes covered with _[_ashpalt_J impregnated jute. 

This cable was installed between Stevens Point, Minnesota, _[_and__[ 
and Minneapolis in 1940. 

Gopher damage to the asphalt and jute (which presumably occurred 
soon after installation) exposed the steel to the corrosive 
_[_enviorment_l of the soil and eventually resulted in failure of the cable. 
Because of this experience, tests with live animals were 
conducted by Livingston, to J^hopefully^J find what thickness of 


:a Aid to personal dictionary. :c Correct spelling with corrector. 

:g Globally change word. :t Type new word here. 

:i Ignore this word for rest of this file. 

Ctrl-N Go to next error. SPELLING 

ashpalt 


If you look at the top line on the screen, you will see: 

to disturbed soil such as that found in an freshly buried 

Because proofvi does not run gram, it did not find the grammatical error, 
"an freshly ...," which proof r found and you corrected in the previous 
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exercise. You can correct this error, however, by using vi commands. Type 

H 

to reach the top line (to "home" the cursor). Now type 

9e 

to skip to the end of the ninth word, "an." Finally, type 
x 

to remove the letter "n." To return to the spelling error "ashpalt," type: 

Ctrl-R 

Ctrl-R (R stands for return) returns the cursor to the current error, which 
does not change until you type Ctrl-N to move to the next error. You can 
use vi move commands to move forward and backward in the text. 
Although you can go forward to the end of the text, you can backup, at 
most, 16 lines. However, no matter how far you move, the program still 
considers the current error to be the last position reached with Ctrl-N. The 
most efficient strategy is to deal with each error in sequence. 

Using the Spelling Menu 

proofvi uses the spellwwb program to find spelling errors and the 
spelltell program to suggest corrections. To find the correct spelling of the 
word that the program identified as misspelled, "ashpalt," type: 

:c 

The menu section of the screen will change and show you the FIND 
CORRECT SPELLING menu (spelling corrector): 
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Figure 2-27 Output of :c 


CR — See next possibility. 

y — Use this word as correct spelling. Correction 

g — Use this word globally as spelling. asphalt? 

q — Quit corrector — not finding right spelling. 

FIND CORRECT SPEILIN3 


After a pause, the menu shows a possible correction; here, the 
suggestion is correct. Type 

y 

and the program will correct the spelling for that individual word in the 
text section and the highlighting will disappear. If you had entered "g" 
(stands for globally), the program would have corrected the word "ashpalt" 
throughout the text. The program corrects only the spelling for the word as 
it is shown, for example, "ashpalt," but not the plural "ashpalts." 

Note that these are the only menu options that do not require a colon or 
a RETURN after you make your choice, and that this is the only menu in 
which you cannot type :h for help, or :q!, :wq, or ZZ to quit. 

One last piece of information for this menu. If the first suggested 
correction is not appropriate, you can see the other words that the program 
suggests as correct by hitting RETURN until you find the correct spelling. 
You will see other spelling options later in the exercise. 

You can see the next error, "and and," in the gopher file by typing: 

Ctrl-N 


Using the Double Words Menu 

With a new error type, a new menu appears in the menu section: 
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Figure 2-28 Output of Double Words Menu 


of .01-inch steel tapes covered with asphalt impregnated jute. 

This cable was installed between Stevens Point, Minnesota, _] and j 
and Minneapolis in 1940. 

Gopher damage to the asphalt and jute (viiich presumably occurred 


:p Program deletes one of the two words. 


Ctrl-N Go to next error. DOUBLE WORDS 

and and 

The proofreading program, double, finds consecutive occurrences of the 
same word. By typing 

: P 

the program automatically eliminates one "and." 

double Summary 

In summary, for any double words identified by double, you can do the 
following: 

1. Delete one of the two words automatically (:p). 

2. Correct the error yourself (vi commands). 

3. Get help with vi commands (:h), although this option is not shown on 
the menu. 

4. Go to the next error (Ctrl-N). 

5. Stop the editing session at any time (:wq, ZZ, :q!). 
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Undoing a Change 

You can use u or U if you want to rescind the last change that you made 
to the text (U rescinds any changes on the same line). By typing 

u 

after entering :p, the word "and" will return to its original appearance. By 
typing 


u 

again, the word "and" will disappear. In general, colon commands, except 
for :p and :c, cannot be undone, vi change commands can be undone. 

Saving Changes 

Before you move on to the next error, look at the text in the figure 
below. You will see the changes that you have made thus far: 

Figure 2-29 Output of Initial Changes 


Many biological organisms cause damage to ccmnunicatian 
wires and cables; bacteria, fungi, insects, rodents, 
and marine borers are examples . 

However, the most rapid and extensive damage is caused 
by various species of rodents. 

• P 

It is generally recognized that gophers are attracted 
to disturbed soil such as that found in a freshly buried 
wire and cable trench. 

One theory for gopher damage is that the animals believe 

the soft lead cables to be roots fran which they can expect water. 

Generally, however, it is believed that rodents must chew to 
keep their incisors sharp and to keep them from growing too long. 

.P 

Because of gopher damage experienced an less important 

cables the first Bell System coaxial cable was protected 

with .01-inch steel tapes covered with asphalt impregnated jute. 

This cable was installed between Stevens Point, Minnesota, 
and Minneapolis in 1940. 

At any time during a proofvi editing session (except when in the spelling 
corrector), you can save the changes you have made to a file. To save the 
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changes you have made so far in gopher, type: 

:w 

proofvi writes the changed version of the file to sv.gopher and the current 
reference file of remaining errors to svref. gopher. You will get the 
following message on the bottom line of the screen: 

"sv.gopher" 42 lines 

:w would also update your personal spellwwb ($HOME/lib/wwb/spelldict) 
and diction ($HOME/lib/wwb/ddict) dictionaries if you had added words 
with :a in the Diction or Spelling menus. 

Now type 

Ctrl-N 

to go to the next error, "enviorment." 


A TUTORIAL INTRODUCTION 


2-63 



Back to the Spelling Menu 

Your screen will now look like this: 
Figure 2-30 Output of Spelling Menu 


keep their incisors sharp and to keep them fran growing too long. 

.P 

Because of gopher damage experienced on less important 
cables the first Bell System coaxial cable was protected 
with .01-inch steel tapes covered with asphalt impregnated jute. 

This cable was installed between Stevens Point, Minnesota, 
and Minneapolis in 1940. 

Gopher damage to the asphalt and jute (which presumably occurred 
soon after installation) exposed the steel to the corrosive 
J^enviorment^ of the soil and eventually resulted in failure of the cable. 

Because of this experience, tests with live animals were 
conducted by Livingston, to J hopefully_J find what thickness of 
material would prevent penetration, and in addition be 
corrosion resistant. 

These tests J which [ used the cables as a barrier indicate [ d that a .01-inch copper 

tape was a reasonable choice. 

This material was first _[_utiliz__[ ed on Bell's Dallas - Los Angeles 


:a Add to personal dictionary. :c Correct spelling with corrector. 

:g Globally change word. :t Type new word here. 

:i Ignore this word for rest of this file. 

Ctrl-N Go to next error. SPELLING 

enviorment 


The cursor has fallen on another spelling error, the word "enviorment," 
and the Spelling menu reappears below the text. Suppose you realize that 
you have consistently misspelled the word "enviorment" throughout the file. 
You can correct it everywhere at once (globally) by typing: 

: g 

The following menu will appear: 
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Figure 2-31 Ouput of :g 


:t Type new ward here. :c Correct spelling with corrector. 


GLOBALLY CORRECT 

Ctrl-N Go to next error. SPELLING 

To enter the word as you want it spelled, type: 

:t 

The following menu will appear: 

Figure 2-32 Output of :t 


Type new word here. TYPE IN CORRECTION 

After the cursor appears next to the phrase "Type new word here," enter 
the correct spelling, environment, and hit RETURN. The new word will 
appear in the text and you will see the Ctrl-N prompt. 

spellwwb Summary 

In summary, for any spelling error identified by spellwwb, you can do 
the following: 

1. Add the word to your personal spellwwb dictionary, 

$HOME/lib/wwb/spelldict. Words are written in spelldict (and ddict) 
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only after you type :w to do a periodic write or quit the editing session. 
Adding the word also causes the word to be ignored elsewhere in the 
same file (:a). 

2. Globally change the word in the file (:g). 

3. Ignore the word during the current editing session (:i). 

4. Run the spelling corrector, spelltell, to find possible corrections for the 
error and make a correction automatically if you request it (:c). 

5. Type in the correct spelling of the word to be inserted by the program 
(:t). 

6. Correct the error yourself (using vi commands). 

7. Get help with vi commands (:h), although this option is not shown on 
the menu. 

8. Go to the next error (Ctrl-N). 

9. Stop the editing session at any time except in the spelling corrector 
menu (:wq, ZZ, :q!). 

Type 

Ctrl-N 

to go to the next error, "hopefully." 
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Back to the Diction Menu 

Since "hopefully" is a diction error, the Diction menu reappears: 
Figure 2-33 Output of Diction Menu 


Because of this experience, tests with live animals were conducted by Livingston, to 

_[_hopefully__[ find what thickness of 

material would prevent penetration, and in addition be 


:s Show substitutions for phrase. :a Aid to personal dictionary to suppress. 

:i Ignore error for rest of file. :h Help with vi cctrmards. 


Ctrl-N Go to next error. DICTION 

hopefully 

Now, type: 

:s 

and the following screen will appear: 

Figure 2-34 Output of :s 


Use for hopefully: hopefully means full of hope 


Ctrl-N Go to next error. 


:b Back to Diction menu. 
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Escaping to the Shell 

There may be times when none of the substitutions or explanations 
suggested by :s seem to be applicable to your text or when you need more 
explanation about why diction flagged the word. You can then use another 
program, worduse, which will give you more information about a diction 
hit. To escape out of the program to use worduse (or any other program) 
without formally leaving proofvi, type 

:!sh 

and then press RETURN and wait for the UNIX system prompt to appear. To 
see more information about the word "hopefully," type 

worduse hopefully 

and press RETURN. You will see the following screen. 

Figure 2-35 Output of worduse 


worduse hopefully 

HDPEETJLLY: [use properly] HDPEEULLY means "in a hopeful 
manner." Many people also use fBPEETJLLY to mean "it is to be 
hoped." Although seme usage experts grudgingly accept this 
second meaning, nary still consider it incorrect. 

In formal writing, use HOPEETJLLY only to convey the first 
meaning. 

FAULTY If you look long enough, hopefully you will 
find it. 

CORRECT Hopefully, I continued my search. 

When the prompt, "word?" appears, type any more words 
you want information about. 

When you want to stop, type q. 

word? 
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By typing 

q 

and then pressing RETURN, you will return to the shell where you can run 
other non-proofvi commands. Type 

Ctrl-D 

to return to the proofvi menu from which you escaped. 

Now type 

dw 

to delete the word "hopefully." 

Skipping an Error 

If your terminal has highlighting, you will see that the next error is a 
diction error, the word "which:" 

Figure 2-36 Output of diction 


corrosion resistant. 

These tests J._which__[ used the cables as a barrier J indicate ] d that 
a .01-inch copper tape was a reasonable choice. 


If you do not want to correct "which," you can skip this error by typing 

2Ctrl-N 

(typing 2 and then Ctrl-N), and the highlighting will disappear from the 
word "which" and the cursor will land on the word "indicated." 
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Figure 2-37 Output of Diction Menu 


used the cables as a barrier __indicate | d that 

a .01-inch copper tape was a reasonable choice. 


:s Show substitutions for phrase. :a Aid to personal dictionary to suppress. 

:i Ignore error for rest of file. :h Help with vi contends . 


Ctrl-N Go to next error. 


DICTION 

indicate 


Suppose "indicate" is a word that you like to use. To prevent it from 
being highlighted as a diction error, type 


:a 

to add the word "indicate" to your personal diction dictionary, 
$HOME/lib/wwb/ddict, and to ignore all other occurrences of "indicate" in 
this file and any later files as long as the word remains in your dictionary. 
The cursor will remain positioned on "indicate," but the word will no longer 
be highlighted. 

Type 

Ctrl-N 

to go to the next error, "utilized." 
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Figure 2-38 Output of Diction Menu 


a .01-inch copper tape was a reasonable choice. 

This material was first J~utiIiz^J ed on Bell's Dallas- Los Angeles coaxial toll cable. 


:s Show substitutions for phrase. :a Add to personal dictionary to suppress. 
:i Ignore error for rest of file. :h Help with vi ccranands. 


Ctrl-N Go to next error. 


DICTION 

utiliz 


The cursor will be positioned on the first letter of "utilized." Suppose 
this is a diction hit that you want to ignore only in this file. You can do 
this by typing: 

:i 

proofvi will ignore the error for the rest of the file, but the word "utilized" 
will not be entered in your personal dictionary. You will see the 
highlighting disappear from the word "utiliz" in both places where it 
appears on your screen. 

diction Summary 

In summary, for any diction error (possibly misused phrase) identified 
by diction, you can do the following: 

1. Show substitute phrases in a new menu (:s). 

2. Show more substitutions if there are more than four (:m). 

3. Ignore reports of the same error type during the rest of the editing 
session (:i). 

4. Add the word or phrase to your personal diction dictionary, 
$HOME/lib/wwb/ddict, to be suppressed. Words or phrases are 
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written in ddict (and spelldict) only after you type :w to do a periodic 
write or quit the editing session. This also suppresses highlighting the 
word or phrase during the rest of the editing session (:a). 

5. Correct the error yourself (using vi commands). 

6. Get help with vi commands (:h). 

7. Go to the next error (Ctrl-N). 

8. Stop the editing session at any time (:wq, ZZ, :q!). 

Typing the Last Ctrl-N 

Now type: 

Ctrl-N 

Since you have instructed the program to ignore the phrase "utiliz," you 
have now Completed reviewing all the errors identified by proofvi. Always 
remember to type Ctrl-N after the last error in the file so that proofvi will 
record your last change. You will see the following message: 

You have seen all possible errors; type :w, :wq(ZZ) , :q!, or :h for help now. 

The commands :wq, ZZ, or :q! will end the session. Remember, using :q! 
will remove ref.gopher. 

Ending the Session 

You can save your changes and quit proofvi at any time during an 
editing session (except when in the spelling corrector menu). Type 

:wq 

or 


ZZ 

to end the session, proofvi will: 

■ Write over your old file with the changes that you have made up to that 
point. Your original file, gopher, remains unchanged until you enter 
these commands. 
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Update the reference file if you have not finished the text and delete it if 
you have finished reviewing all the errors. 

Remove any intermediate sv.files. 

Add words to your personal diction dictionary. 
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More on proofvi 


Now that you are familiar with how proofvi works, here are some 
additional features, including a synopsis of some of the commands that you 
can use. 

Using the — e Option 

If you do not want to wait for a mail message, you can run proofvi 
using the — e option: 

proofvi — e gopher 

proofvi prints messages on the screen while you wait to tell you which of 
the four proofreading programs it is running. For example: 

It is now looking for spelling errors . 

It is now locating those errors. 

When the reference file is complete, proofvi automatically begins running 
in its interactive editing mode. 

Other Ways of Ending the Session 

If you quit the file before making any changes, you will then be asked: 
Do you want to save your reference file, ref. gopher? (y or n) 

By answering y, you will be able to return to the file later without waiting 
for a mail message by typing: 

proofvi gopher 

If you answer n, you will receive the following message: 

Your reference file, ref .gopher, has been removed. 


If you quit before completing all the changes, your reference file will be 
updated to reflect the changes you have made and will be saved. You will 
receive the following message: 
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You have an updated reference file, ref .gopher, 

which you can use if you want to look at the rest of the 

possible errors later, by once again typing "proofvi gopher. 


If you quit using :q!, the program will: 

■ Eliminate any changes that you made to that point if you have not used 
:w to save them in sv.file. 

■ Give you the following message: 

Your reference file, ref .gopher, has been removed. 

■ If you have used a :w during the session, you will receive the following 
message: 

Your reference file, ref .gopher, has been removed. 

You can start up the second stage of proofvi again, 

where you were when you typed :w, by typing proofvi —r gopher. 

■ If you have not made any changes to the file, you will receive the 
following message: 

Do you want to save your reference file, ref .gopher? (y or n) 

Recovering from System Crashes 

Recovery from system crashes is made easier if you type :w sometime 
(or several times) during your editing session. If the editing session is 
interrupted by a kill signal or a system crash, you can type 

proofvi — r file 

on the command line to recover sv.file. proofvi checks to see if the files, 
sv.file and svref .file, exist. If they exist, you would receive, for example, 
the following message: 
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Your file was saved frcrti your last :w. 

The differences between it and your original 
file are shown now: 
line 15 

OLD: one theory for gopher damage is that the animals believe 
NEW: One theory for gopher damage is that the animals believe 
Do you want to move the new one over the old? (y or n) 

If you then answered y, you would see: 

The current reference file for gopher is in 
ref .gopher. To run the interactive program just trype 
proofvi gopher 

If you answered n instead, you would see: 

This program will leave you with two files, sv. gopher and 
its corresponding reference file, svref .gopher. 

You can run proofvi on them with the oanxnand 
pxroofvi — f svref .gopher sv. gopher. 

Your original file gopher will not show the change to the word "one"; that 
change will remain in sv.gopher. 

If you had not used :w to save your changes, the message would read: 

There are no saved files in this directory. 


There is one case where you can recover a file even if you forgot to type 
:w. If you have been working on a file (for example, named report) longer 
than 32 lines and have moved beyond about 50 lines, proofvi will have 
begun to store cumulative changes to your file in a temporary file called 
i.report. If the session is then interrupted, you will receive the following 
message when you type proofvi -r report: 
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proofvi -r report 

Ycu do not have any files saved fran a :w contend. While proofvi was 
running, it was building an output file, and so you now have a partial 
output file called i. report. It is a partial file because proofvi is a 
stream editor that writes out lines only as they pass out of its 
buffer. Urns, the file, i. report, has only the beginning of your file up 
to about 30 lines before your last change. Changes that were still in 
the buffer at the time of the crash were not saved. To prevent losing 
changes in the future, use the :w ocnmand periodically. 

If ycu think the effort is worth it, you can try to natch up the 

partial file with the ending of your original file. Your original 

file, report, has 168 lines in it, while the new file, 

i. report, has 126 lines in it. To merge these two files, edit 

cut the carparable lines in your original file arri then read in the new 

file with the command "Or i. report" with ed or ":0r i. report" with vi. 

Using the — f Option 

The proofvi — f option is used to identify renamed reference files or to 
use reference files that are older than the input file. If you use the — f 
option to name the reference file, and that reference file exists, but is older 
than the input file, proofvi prints a warning and asks you whether to use 
that reference file in an interactive editing session. For example, if you ran 
proofvi on gopher to get ref.gopher and then you made changes to gopher 
with a text editor (not proofvi), the line and column numbers of your errors 
stored in ref.gopher might no longer match the file, gopher. If you then 
type: 

proofvi — f ref.gopher gopher 

You will receive the following warning: 

Warning, ycur file gopher has been modified since the 
reference file was created. Do you want to continue 
anyway? (y or n) 

If you enter y, proofvi will continue using the modified file, but the 
highlighting of errors may not be in the right place. 

If the reference file was not renamed, you do not need to specify it after 
the — f flag, because proofvi checks for ref.fi'/e automatically. However, if 
ref. file is not in your current directory, you must specify the full pathname 
after the — f flag. 
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If you list several files on the command line, for example, 

proofvi gopher myfile yourfile 

proofvi will create a separate reference file for each file. When multiple 
files are given, the — f option cannot be used. When multiple files are given 
with the — e option, proofvi reruns itself and allows you to correct errors 
interactively for each file in turn. 

proofvi Commands 

Figure 2-39 lists the allowable proofvi commands: 

Figure 2-39 Menu Commands 


Command 

Function 

Menu 

:a 

Add to personal dictionary. 

Spelling 


Add to personal dictionary to 
suppress. 

Diction 

:b 

Back to Diction menu. 

Diction 

:c 

Correct spelling with corrector. 

Spelling 

:f 

vi command. Shows file name 
and number of errors left. 
Equivalent to Ctrl-G. 

Any menu except 
spelling corrector 

••g 

:h 

Globally change word. 

Help with vi commands. 

Spelling 

Any menu except 
spelling corrector. 

:? 

Same as :h. 

Any menu except 
spelling corrector. 
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Figure 2-39 Menu Commands (continued) 


Command 

Function 

Menu 

:i 

Ignore this word for rest of this 
file. 

Spelling 


Ignore error for rest of file. 

Diction 


Ignore this error type for rest of 
file. 

Punctuation 

:1 

vi command. Shows the 
underlying form of the line (e.g., 
prints tab characters). 

Any menu except 
spelling corrector. 

:m 

More substitutions. 

Diction 

•P 

Program deletes one of the two 
words. 

Double 


Program makes suggested change. 

Punctuation 

:wq 

vi command. Quit the program 
and overwrite the original file. 

Any menu except 
spelling corrector. 

:q! 

vi command. Quit the program 
without overwriting the original 
file. 

Any menu except 
spelling corrector 

:s 

Show substitutions for phrase. 

Diction 

:t 

Type new word here. 

Spelling 
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Figure 2-39 Menu Commands (continued) 


Command 

Function 

Menu 

:w 

vi command. Write changes to 

Any menu except 


sv.file and write an updated 
reference file to svref .file. 

spelling corrector 

ZZ 

Same as :wq. 

Any menu except 
spelling corrector 

:!sh 

Temporary escape from proofvi. 

Any menu except 


Use Ctrl-D to return. 

spelling corrector 


vi Commands 

These are some of the vi commands that you can use to edit the 
displayed file. A complete list is given on the proofvi manual page in 
Chapter 3. 
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Figure 2-40 vi Commands 


Function 

Command 

Cursor movement 

j, k, h, 1, +, RETURN, 
SPACE BAR, H, L, M 

Delete letter 
word 

line 

x, dSPACE BAR 
dw 

d$, dd, D 

Change letter 
word 

line 

r, s*, cSPACE BAR* 
cw* 

c$*, cc*, C*, S* 

Insert /append 

i*, a*, I*, A* 

Search 

b, B, e, w, W, f, F, t, T, ; 

Scrolling forward 
backward 

Ctrl-D, Ctrl-F 

Ctrl-U, Ctrl-B 

Redraw screen 

Ctrl-L 

Open new line 

o 

¥ 

o 

¥ 

Put last deleted text 

P,P 

Last change action redo 
undo 

u, U 

Status queries 

Ctrl-G, :f 

Change case 



* Requires an ESCAPE to get out of input mode. 
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3 The WRITER’S WORKBENCH System 

Manual Pages 


Overview 3-1 


abst 

3-7 

aero 

3-9 

conscap 

3-13 

consist 

3-15 

conspell 

3-19 

continge 

3-21 

continrls 

3-25 

dictadd 

3-29 

diction 

3-33 

diversity 

3-37 

double 

3-41 

findbe 

3-43 

gram 

3-47 

match 

3-49 

mkstand 

3-53 

morestyle 

3-59 

murky 

3-65 

neg 

3-73 

org 

3-77 

parts 

3-81 

proofr 

3-85 

proofvi 

3-89 

prose 

3-95 


prosestnd 

3-103 

punct 

3-105 

punctrls 

3-109 

reroff 

3-111 

sexist 

3-1 15 

spelladd 

3-119 

spelltell 

3-121 

spellwwb 

3-123 

splitrls 

3-127 

style 

3-129 

switchr 

3-135 

syl 

3-139 

tmark 

3-141 

tmarkrls 

3-145 

topic 

3-147 

worduse 

3-151 

wwb 

3-153 

wwbaid 

3-163 

wwbhelp 

3-167 

wwbinfo 

3-169 




Introduction 


This chapter includes the manual pages, given in alphabetical order, for 
each of the WRITER'S WORKBENCH programs. The manual pages include the 
following information: 

■ a command synopsis, or syntax, line 

• a program description 

■ definitions of the options and arguments 

■ known limitations 

• lists of related programs 

• output examples and explanations 

Two input files, named exfile and orders, are used to obtain most of the 
example outputs on the manual pages; the files are shown in Figures 3-1 and 
3-2, respectively. The preface to the manual was used in the example for the 
org command, and a file called marks was used in the example for the tmark 
command. A copy of marks is shown in Figure 3-3. 


MANUAL PAGES 
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Figure 3-1 exfile. Shown with Formatting Commands 


Mar 12 22:43 1985 exfile Page 1 

1 .SA 1 

2 .PH "" 

3 .nr Hy 0 

4 .nr Pt 1 

5 .P 

6 Many biological organisms cause damage to canmunication 

7 wires and cables; bacteria, fungi, insects, rodents, 

8 and marine borers are examples . Hcwever , the nest rapid and 

9 extensive damage is caused by various species of rodents. 

10 .P 

11 As early as 1935 the English reproted rat damage to 

12 lead sheathed cables, and in 1937 Gertsch reported 71 cases 

13 of rodent attack bo cables, later, Lizell et. al. ran tests 

14 with caged adult female white rats that were given adequate 

15 food and water. All rubber and plastic materials were 

16 attacked; the harder the material and the larger the sample, 

17 the more difficult it was far the animals to cause damage. 

18 .P 

19 Since the early studies of gopher-resistant materials, 

20 an large number of new wire, cable, and designs have been developed and 

21 and many new materials are available. 

22 The Denver Wildlife and Research Centre (EWRC) and the Bell Telephone 

23 Laboratories decided to join together to test the gopher resistance 

24 of the new designs. 

25 The manpower for the experiments came from both 

26 DWRC and BTL; 

27 Bell prepared the test samples, tock photographs 

28 after exposure to gophers, and analyzed the engineering 

29 implications of the results, and the dwrc designed and 

30 conducted the exposure test and rated the damage to the 

31 samples. 

32 .P 

33 The animals were housed in individual cages in 

34 a standard laboratory bioassay rack. 

35 The diet consisted of laboratory chow, 

36 carrots and occasionally dry alfalfa, but no water. The 

37 gophers were not separated as to size or sex. Specimens 

38 were randomly tested with individual gophers. 
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Figure 3-1 exfile. Shown with Formatting Commands (continued) 

39 .P 

40 The natural tendency of gophers to repeatedly chew an objects 

41 eliminated the need to provide any incentive such as food 

42 near the specimens. 

The file was printed with pr -n exfile. The line numbers are not in the 
file, but are included for easy reference, exfile contains a variety of errors 
and weaknesses and will be used in this chapter to illustrate many of the 
programs. 
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Figure 3-2 orders. Shown with Formatting Commands 


Mar 22 10:52 1985 orders Page 1 

1 .SA 1 

2 .nr Hy 0 

3 .nr Pt 1 

4 .HO "Service Orders" 

5 ANDNYMOS processing of service orders is a two step procedure. 

6 You must obtain an order, complete the work, and notify ANONYMDS 

7 that you have completed the work. 

8 After you run the Cpen of Day, use PCR to obtain 

9 the list of service orders and the work orders with a specified 

10 due date. 

11 When the PAO establishes an order with a "HOT" status — that is, 

12 one needing immediate attention — car one with frame 

13 due date of today or tomorrow a bell rings at the frame; 

14 transaction FOR is then used to obtain this order. 

15 .P 

16 The FOR output contains all the information needed to complete 

17 the order. 

18 The order number, order type, and any related order numbers are 

19 given along with the facilities listed in schematic order. 

20 label each facility IN, COT, or REU, and give its location. 

21 Occasionally, a new connect service order will not 

22 be able to use the line equipment associated with a DIPed cable 

23 pair; in these cases, send a message to the frame to break the DIP. 

24 Send a separate order to connect the new circuit, and 

25 list any special, required security protection. 

26 .P 

27 The PAO can change, cancel, or withdraw a service order or change 

28 the frame due date. 

29 In all cases, if the frame output is next requested, then notify 

30 the Frame . 

31 A service order is normally cancelled in ANGNYMDS when it is the 

32 result of a customer request. 

33 You can change a service order through an assignment change 

34 ticket, a service order modification, or a change-of -due-date . 

35 The order can also be withdrawn and reestablished. 
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Figure 3-3 marks. Shown with Formatting Commands 


Jul 2 13:54 1985 marks Page 1 

1 .P 

2 A trademark is any ward, name, symbol, or device used by an enterprise 

3 to identify and distinguish its product frcm those manufactured or sold 

4 by others. 

5 To use a trademark properly, it must be always used as an adjective 

6 modifying the generic or ocmmcm name of a product or service. 

7 Bor example, words like "UNIX" and "DIMENSION" 

8 should never be used alone in a sentence, but rather should 

9 always be part of a word grouping such as "the UNIX system" 

10 or "the UNIX operating system" and "DIMENSION PHX 

1 1 system" or "DIMENSION teleccranunicatians switching apparatus . " 

12 In addition, trademark names should be capitalized. 

13 .P 

14 Those products and services that are protected by trademarks should 

15 also include a mark indicating proper ownership. 

16 The legend TM (for example, UNIX WRITER'S WORKBENCH™) following 

17 the trademark on a product or appearing in a footnote 

18 shows that the trademark is protected under the ccmmcn law of one or 

19 more states through use of the nark in trade. 

20 The ® symbol (for example, WE® 32000 Microprocessor) indicates 

21 that a mark is registered in the U.S. Patent and Trademark Office under 

22 federal law. 

23 Registration takes time to obtain-usually one to two years. 

24 The TM is available as soon as the mark is used in trade. 
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abst 


abst 


NAME 

abst - analyze a document for abstractness 
SYNOPSIS 

abst [-dlsOV] [ — ] file ... 

DESCRIPTION 

abst analyzes a document to determine how abstract it is by counting words 
in the document that appear in a dictionary of abstract words. It reports the 
percentage of total words that are abstract, abst also asks if you want the list 
of abstract words it found saved in your current directory in a file called 
ab .file. 

When you give abst multiple input files, it will report on each file separately 
and in sequence, abst is one of the programs that is run by morestyle. 

Options are: 

-d 

-1 


— s 

-O 

-V 


USES 

abst can be used to identify documents that are abstract. You can then add 
concrete examples or explanations to a conceptually abstract document to pro- 
vide the reader with a base for understanding the abstract ideas. 

FILES 

/usr/lib/wwb/abst.d dictionary of abstract words 

ab.file contains abstract words and the number of times they 

appear in the document 

/tmp/$$* temporary files 

SEE ALSO 

morestyle 

EXAMPLE 

Safest exfile 
abst —1 exfile 

Texts differ in the extent to vrtiich they refer to concrete 
objects and abstract ideas. Concrete objects, places, or things can 
be seen, heard, felt, smelled, or tasted. Abstract ideas, an the other 
hand, cannot be experienced by our senses. Fran the results of 
psychological research, we knew that concrete texts are easier to read, 
easier to use, and easier to remember. 


Print the pathname of the abst dictionary of abstract words, then 
exit. 

Produce a long version, including explanations. This is the 
default. (You can change this default by setting the environmen- 
tal variable WWBLEV. See the note on the manual page for 
wwb.) 

Produce a short version, which is a report of the percentage of 
abstract words in the text. 

Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

Delimit the end of the options. 
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In file "exfile," 2.2 percent of the words are abstract words, 

which is a good score. 

The abstract words in file "exfile" are stored in file 
"ab. exfile." Do you want to save it? (y or n) 

>y 

EXAMPLE EXPLANATION 

1. The command line shows you want your text, exfile, evaluated for 
abstractness. 

2. abst displays the options it is using. Here, it is using the default, — 1, 
option to produce the long version of output, which includes explana- 
tions. 

3. The output reports that 2.2 percent of exfile's words are abstract, 
which is a good score. If the input text had more than 2.3 percent 
abstract words, an additional explanatory paragraph would have been 
printed. 

4. The program stores the abstract words from exfile in ab.exfile, and 
asks whether to save that file. Type y or n after the ">" prompt. 
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NAME 

aero — find acronyms in a text file 
SYNOPSIS 

aero [— OV] [— m m|n|s] [reroff-options] [ — ] file ... 

DESCRIPTION 

aero searches for acronyms in a text file and prints a frequency count of all 
acronyms used in the text. It also prints each sentence containing an acronym 
and surrounds the acronym with asterisks and brackets, *[ ]*. When you give 
aero multiple input files, it will report on each file separately and in 
sequence. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 

— m n The input text does not contain macros; it is already formatted. 
The program uses reroff to identify text that is not part of sen- 
tences and eliminates that text from the analysis. 

-m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 

reroff-options 

Use only with the — m n option. 

— h All line-end hyphenated words will retain their hyphens in 

the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if num= 1, double-spaced if num= 2, 
triple-spaced if num= 3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

— Delimit the end of options. 


NOTE 

If you use formatting header files (which can contain formatting commands 
and definitions of macros), include them as part of the input text. This is 
necessary because aero runs deroff on files to strip formatting commands and 
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headings from the input, and deroff needs to know about formatting com- 
mands you have defined yourself in order to interpret them later. If your text 
does not contain macros, aero can run reroff to identify text that should be 
ignored in the analysis (use the — m n option). 

USES 

Use aero to locate acronyms in text. Then check to see that an acronym is 
fully defined when it is first used. 

FILES 

/tmp/$$* temporary files 

SEE ALSO 

deroff, reroff 

EXAMPLE 

$acro exfile 
aero -m m exfile 

This program searches far acronyms in a text file. 

It will also find words that are printed in capital letters. 

Your readers may be unfamiliar with the acronyms that 
appear in your document. Check the first time each is 
used and make sure it is fully defined. 


The following acronyms are used in file "exfile": 

1 BTL 

2 DWRC 

Acronyms appear an the following lines of "exfile”: 
beginning line 22 exfile 

The Denver Wildlife and Research Centre *[(DWRC]*) aid the Bell 
Telephone Laboratories decided to join together to test the gopher 
resistance of the new designs. 

beginning line 25 exfile 

The manpower far the experiments came from both 

*[ EWRC]» and *[ BCTL]»; Bell prepared the test sartples, took photographs 
after exposure to gophers, and analyzed the engineering implications 
of the results, and the dwrc designed and conducted the exposure 
test and rated the damage to the samples. 

file exfile: number of lines 42 number of phrases found 3 

EXAMPLE EXPLANATION 

1. The command line shows you want your text, in the file named exfile, 
searched for acronyms. 

2. aero displays the options it is using. Here, it is using the default op- 
tion, — m m, to run deroff, which eliminates macros and text that is 
not part of sentences. 
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3. The output lists the acronyms found and how many times they ap- 
pear. BTL appeared once; DWRC appeared twice. 

4. The output also shows the sentences that contain an acronym. Each 
acronym is surrounded by asterisks and brackets (for example, 
*[ BTL]*). (Note that the acronym DWRC appears on line 28 in lower- 
case; use conscap to locate inconsistent capitalization.) 

5. The program reports that there are 42 lines in your file, and it found 3 
acronyms in the text. 
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NAME 

conscap — find inconsistent capitalization 
SYNOPSIS 

conscap [— OV] [— m m|n|s] [reroff-options] [ — ] file ... 

DESCRIPTION 

conscap searches the input text (except for headings defined by formatting 
macros) for words spelled in all uppercase letters that also appear spelled with 
all lowercase letters or with only the first letter capitalized, conscap prints a 
list of the words that are capitalized inconsistently together with the number 
of times each capitalization occurs. 

When you give conscap multiple input files, it will run on each file separately 
and in sequence, conscap is one of the programs run by consist. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 

— m n The input text does not contain macros; it is already formatted. 
The program uses reroff to identify text that is not part of sen- 
tences and eliminates that text from the analysis. 

— m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 

reroff-options 

Use only with the — m n option. 

— h All line-end hyphenated words will retain their hyphens in 

the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if num= 1, double-spaced if num=2, 
triple-spaced if num= 3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

Delimit the end of options. 
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NOTE 

If you use formatting header files (which can contain formatting commands 
and definitions of macros), include them as part of the input text. This is 
necessary because conscap runs deroff on files to strip formatting commands 
and headings from the input, and deroff needs to know about formatting 
commands you have defined yourself in order to interpret them later. If your 
text does not contain macros, conscap can run reroff to identify text that 
should be ignored in the analysis (use the — m n option). 

SEE ALSO 

consist, deroff, reroff 

BUG 

conscap first searches the input file for words spelled in capital letters. It will 
not find spelling inconsistencies between a word with an initial capital letter 
and the same word when it is not capitalized at all (for example, “Depart- 
ment" and “department") unless the word is spelled in all capitals at least 
once in the file ("DEPARTMENT”). 

EXAMPLE 

Scanscap exfile 
conscap -m m exfile 

For file exfile: 

The following words were capitalized inconsistently: 

Number of 

Occurrences Word 

2 EWRC 

1 dwrc 

EXAMPLE EXPLANATION 

1. The command line shows you want your text, in the file named exfile, 
searched for inconsistent capitalization. 

2. conscap displays the options it is using. Here, it is using the default 
option, — m m, to run deroff, which eliminates macros and text that is 
not part of sentences. 

3. The output shows the number of occurrences of the inconsistent capi- 
talizations. 
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NAME 

consist - find inaccuracies in trademarks and service marks and inconsisten- 
cies in capitalization and British and American spelling 

SYNOPSIS 

consist [-IsOV] [-m m|n|s] [reroff-options\ [ — ] file ... 

DESCRIPTION 

consist finds inaccuracies in the use of trademarks and service marks and also 
finds inconsistencies in capitalization and British and American spelling by 
running three programs: tmark, conscap, and conspell. When you give con- 
sist multiple input files, it will run tmark on each file in turn, then run con- 
scap on each file, and finally conspell. 

Options are: 

-1 Produce a long version of the tmark output. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBLEV. See the note on the manual page for wwb.) 

— s Produce a short version of the tmark output. 

— O Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 

— m n The input text does not contain macros. The program uses reroff 
to identify text that is not part of sentences and eliminates that 
text from the analysis. 

— m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 

reroff-option 

Use only with the — m n option. 

— h All line-end hyphenated words will retain their hyphens in 
the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if mun= 1, double-spaced if num= 1, 
triple-spaced if m/m= 3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 
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— Delimit the end of options. 

NOTE 

If you use formatting header files (which can contain formatting commands 
and definitions of macros), include them as part of the input text. This is 
necessary because consist runs deroff on files that contain formatting macros 
to strip non-sentence text from the input, and deroff needs to know about for- 
matting commands you have defined yourself in order to interpret them later. 
If your text does not contain formatting commands, consist can use reroff to 
identify text that should be ignored in the analysis (use the — m n option). 

SEE ALSO 

conscap, conspell, deroff, dictadd, reroff, tmark, tmarkrls 

BUGS 

See other manual pages for bugs in individual programs. 

EXAMPLE 

$ consist exfile 
consist — 1 -m m exfile 


******************************** TRADEMARKS ********************************** 
No misused trademarks or service marks found. 


************************* CONSISTENT CAPITALIZATION ************************* 

For file exfile, the following words were 
capitalized inconsistently: 

Number of 

Occurrences Word 

2 DWRC 

1 dwrc 


**************************** CONSISTENT SPELLING **************************** 

Seme words have two spellings: one preferred in American English (for 
example, "color"), and the other preferred in British English ("colour"). 

Mixing British and American spellings in a document can distract readers 
fran your message. 

Your document, exfile, uses some British and sane 
American spellings of words. If you are writing for an American audience, 
change all the British spellings of words to their preferred American spellings. 

The American spellings are the following : 
analyzed 

The British spellings are the following: 

Centre 
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EXAMPLE EXPLANATION 

1. The command line shows you want to analyze your text, exfile, using 
the consist program, which runs tmark, conscap, and conspell. 

2. consist displays the options it is using. Here, it is using two default 
options, —1 and — m m, as it runs on exfile. The program will produce 
the long version of tmark and use deroff to eliminate mm macros and 
text that is not part of sentences. 

3. The output reports the results of running the tmark, conscap, and 
conspell programs on your text, exfile does not contain any incorrect- 
ly used trademarks or service marks. 
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NAME 

conspell — identify inconsistent use of British and American spelling 
SYNOPSIS 

conspell [— OV] [ — ] file ... 

DESCRIPTION 

conspell finds words in the input text that have both British and American 
spellings (for example, "color" and "programme"). If it finds both American 
and British spellings in the same document, it prints a message about the 
inconsistency and then lists those words in the document with American spel- 
lings followed by a list of those with British spellings. 

When you give conspell multiple input files, it will run on each file 
separately and in sequence, conspell is one of the programs run by consist. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— Delimit the end of the options. 

SEE ALSO 

consist 

EXAMPLE 

Scanspell exfile 
conspell exfile 

Seme words have two spellings: cue preferred in American English (far 
example, "color"), and the other preferred in British English ("colcur"). 

Mixing British and American spellings in a document can distract readers 
fran your message. 


Your document, exfile, 

uses seme British and seme American spellings of words. 

If you are writing far an American audience, change all the 
British spellings of words to their preferred American spellings. 

The words spelled with American spellings are the following: 
analyzed 

The words spelled with British spellings are the following: 
Centre 


EXAMPLE EXPLANATION 

1. The command line shows you want your text, in the file named exfile, 
searched for inconsistent use of British and American spelling. 

2. conspell displays the command line, showing that there are no default 
options. 

3. The program first explains that mixing American and British spelling 
can distract the reader. 
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4. conspell then reports that there are both American and British spel- 
lings in exfile. The program lists the word with the American spel- 
ling, "analyzed," followed by the word with the British spelling, "Cen- 
tre." 
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NAME 

continge — report contingencies in procedural text 
SYNOPSIS 

continge [— clnsOV] [— g format-options] [— r m|n|s] [ ] file ... 

DESCRIPTION 

continge analyzes the wording of decision points, or contingencies, in pro- 
cedural documents, which describe how to do something. In a section labeled 
DISPLAY OF CONTINGENCIES, continge reports the number of contingency sig- 
nals (words such as "if,” "when," "except," and "whenever") that are within 
paragraphs in the document (instead of in a contingency table or a logic tree). 

In a section labeled WORDING OF CONTINGENCIES, continge reports the sen- 
tences that may contain poorly worded contingencies (contingencies without 
explicit referents, such as "otherwise" and "unless") with the contingency sig- 
nal enclosed in asterisks and brackets (*[ ]*). continge also explains how con- 
tingencies can be displayed more clearly. 

You can also format and print the document with all the contingency words 
capitalized and set off with spaces with the — c option. 

When you give continge multiple input files, it will run on each file 
separately and in sequence. 

Other related programs are continrls and murky, continrls provides informa- 
tion about clear ways to present contingencies, murky identifies sentences in 
procedural text that are passive, have high Automated Readability Index (ARI) 
scores, or have poorly worded contingencies. 

Options are: 

— c Print the input text formatted with the contingencies 

highlighted. 

—1 Produce a long version, which provides statistics about the con- 
tingencies used, explains how they should be displayed and 
worded, presents examples, and lists sentences from the input 
text that contain poorly worded contingencies. This is the 
default. (You can change this default by setting the environmen- 
tal variable WWBLEV. See the note on the manual page for 
wwb.) 

— n Do not produce the long or short version of the report; only 

print the input text formatted with the contingencies 
highlighted. (Use only with the — c option.) 

— s Produce a short version, which provides statistics about the con- 

tingencies used and lists sentences from the input text that con- 
tain poorly worded contingencies. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— g format-options 

Give format-options to the formatter to format the output. (Use 
only with the — r m or — r s options.) 
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USES 


— r m Use mm to produce — c output. The program uses mm to format 
the output. (Use only with the -c option.) This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for findbe.) 

— r n Do not use a formatter to produce — c output. The input text 

does not contain macros; it is already formatted. Print the input 
text with contingencies capitalized. (Use only with the — c 
option.) 

— r s Use nroff —ms to produce — c output. The input text contains ms 

macros. The program uses nroff -ms to format the output. (Use 
only with the — c option.) 

— Delimit the end of options. 


continge makes searching for occurrences of contingency statements easier. It 
should be used for early drafts of documents to ensure that contingencies are 
clearly presented. 


SEE ALSO 

continrls, murky, style 

EXAMPLE 1 

$ continge orders 


continge —1 orders 


For file orders: 


NOTE: This program is suitable for analyzing the treatment of 
contingencies in procedural text. It may also be 
useful for other types of text, such as legal 
documents, which contain rrany contingencies. 

There are 4 contingencies in orders. 

This program describes how the display and wording of these 
contingencies may affect hew well people can use the 
the instructions in orders. 

DISPLAY OF CCmiNGENCIES 

Research shows that contingencies presented in paragraphs 
are often harder to follow than contingencies presented in 
nan-paragraph form. This is particularly true when several 
contingencies are grouped together in one paragraph. 

The text in orders has 1 paragraph! s) containing two contingencies 
and 2 paragraph! s) containing one contingency pier paragraph. It has no 
paragraphs that contain more than two contingencies . 

These statistics show that this text falls into a middle 
range in its treatment of contingencies. It correctly 
avoids grouping many contingencies together in single 
paragraphs, but it presents contingencies in paragraph 
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rather than non-paragraph form. 

For maximum clarity, try using non-paragraph displays for 
the contingencies in this text. Recommended non-paragraph 
forms include IF-THEN lists, IF-AND-THEN contingency tables, 
and logic trees. (Use the ccmmand "cantinrls" to get more 
information about these methods of displaying 
contingencies . ) 

Use the ccnrrand: 

continge -c -n orders 

to see a formatted version of your file with the 
contingencies highlighted. 

WORDING OF CONTINGENCIES 

Excellent; orders does not use the words "else" and "otherwise." 

Words such as "except," "unless," and "when" usually involve 
contingencies. Rewriting sentences containing these words to 
more positive and explicit IF-THEN forms will usually make 
the information easier to use. 

For example, you might rewrite the instruction: 

"Change the fuse *[unless]* the meter reading is greater than 8 volts." 
to the form: 

"IF the meter reading is 8 volts or less, THEN change the fuse." 

Examine each of the following sentences. 

Most of them contain contingencies. Try to reword these 
contingencies to more positive, more explicit forms. 


beginning line 11 orders 

♦ [When]* the PAD establishes an order with a "HOT" status — that 
is, one needing immediate attention — or one with frame due date 
of today or tomorrow a bell rings at the frame; transaction FCR 
is then used to obtain this order. 

beginning line 21 orders 

Occasionally, a new connect service order will not be able to 
use the line equipment associated with a DIPed cable pair; 

*[in these cases]*, send a message to the frame to break the DIP. 

beginning line 31 orders 

A service order is nonrally cancelled in ANCNXMDS 
♦[when]* it is the result of a customer request. 
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EXAMPLE 1 EXPLANATION 

1. The command line shows you want your text, in the file named ord- 
ers, analyzed for contingencies. 

2. continge displays the command line, showing that it is using the de- 
fault option, —1, to produce the long version of output. 

3. The program notes that it is suitable for use with procedural text and 
tells you there are 4 contingencies in orders. 

4. The DISPLAY OF CONTINGENCIES section reports the number of con- 
tingencies in your text and states that your text falls in the middle 
range in its treatment of contingencies. The program makes some 
suggestions for handling contingencies, suggests you use continrls to 
get more information, and shows you the command line to see a for- 
matted version of your file with contingencies highlighted. 

5. The WORDING OF CONTINGENCIES section gives you the beginning 
line number of sentences in your text with contingencies and then 
prints those sentences with the contingency words highlighted in as- 
terisks and brackets. 

EXAMPLE 2 

The command 

continge — cn — g T450 proc.doc 

does not produce either the long or short version of the report. It formats the 
input text with nroff -mm (by default) and prints the document with the 
contingencies highlighted. The formatting option, — g T450, prepares the out- 
put for the specified terminal type. 
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NAME 

continrls — print information about clear ways to present contingencies 

SYNOPSIS 

continrls [— OV] 

DESCRIPTION 

continrls provides information about clear ways to present contingencies. 
Contingencies are decision points at which the next action depends on the 
current state of specific conditions. Words such as "if," "when," and "unless" 
usually indicate contingencies. When you run continrls at a terminal, it will 
automatically produce one screenful of output at a time. You can press 
RETURN to get the next page. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

SEE ALSO 

continge, murky, style 

EXAMPLE 

Scantinrls 

Presenting Contingencies 

Research shows that contingencies presented in block paragraphs 
are often harder to follow than contingencies presented in 
non-paragraph forms. Suggested non-paragraph forms include 
IF-THEN lists, IF-AND-THEN contingency tables, and logic trees. 

IF-THEN List EScanple 


! IF the light is 

THEN 

! red 

stop 

! yellow 

proceed with caution 

! green 

go 


o Use an IF-THEN list when you have one decision to 
display. 
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IF-AND-THEN Contingency Table Exanple 


IF 

AND 

THEN 

the traffic 
light is red 


stop 

the traffic 
light is yellcw 

there is traffic 

proceed with 
caution 

there is no 

traffic 

go 

the traffic 
light is green 


go 


o Use an IF-AND-THEN contingency table when you have two 
decisions in succession to display. 


Logic Tree Exanple 


What color is 
the traffic light? 

I 

I 

Red ! Green 


Stop Is the intersection 

dangerous? 

I 

I 

No ! Yes 

i : 

! Proceed with 

! caution. 

Is visibility poor? 

I 

I 

No ! Yes 

I ! 

Go. Proceed with caution, 

o Use a logic tree far three ar more consecutive decisions. 

References 

o See Chapter 5 in the Handbook for Writing Procedures 
for additional information an displaying contingencies. 

The handbook is available from AT&T Custoner Information 
Center (CIC) , P.0. Box 19901, Indianapolis, IN 46219. 

Phone 1-800-432-6600 toll free. Specify Select Code 
700-242 when ordering. 
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EXAMPLE EXPLANATION 

1. The command line shows you want to read the information the 
WRITER'S WORKBENCH system provides about clear ways to present 
contingencies. 

2. The output shows IF-THEN lists, IF-AND-THEN contingency tables, and 
logic trees that will help you organize and clarify the way you present 
contingencies. 
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NAME 

dictadd — add words or phrases to the diction, sexist, spellwwb, and tmark 
personal dictionaries 

SYNOPSIS 

dictadd [-OV] 

DESCRIPTION 

dictadd creates and adds words or phrases to your personal dictionaries for 
use by the consist, diction, proofr, proofvi, sexist, spellwwb, tmark, and 
wwb programs. 

dictadd prompts you to add words to these dictionaries. If the dictionary is 
not in existence when dictadd is invoked, it is created; if the dictionary 
already exists, dictadd adds to it. To quit, type q after the prompt. 

consist, diction, proofr, proofvi, sexist, spellwwb, tmark, and wwb search 
the following personal dictionaries (in the $HOME/lib/wwb directory) for 
words or phrases to locate in addition to those in the standard WRITER'S 
WORKBENCH system dictionaries. 

■ $HOME/lib/wwb/ddict is automatically searched by diction, proofr, 
proofvi, and wwb. ddict can contain additional words or phrases for these 
programs to find, and it can contain words or phrases that you want the 
programs to stop flagging. 

■ $HOME/lib/wwb/sexdict is automatically searched by sexist, sexdict can 
contain additional words or phrases for sexist to find, and it can contain 
words or phrases that you want the program to stop flagging. 

■ $HOME/lib/wwb/spelldict is automatically searched by spellwwb, proofr, 
proofvi, and wwb. spelldict can contain correctly spelled words that are 
not in the standard UNIX system spelling dictionary. 

■ $HOME/lib/wwb/tmarkdict is automatically searched by tmark and con- 
sist. tmarkdict can contain additional trademarks and service marks for 
these programs to find, and it can contain trademarks and service marks 
that you want the programs to stop flagging. 

■ dictionary-file is a file named by you and searched by diction, sexist, 
tmark, or spellwwb, only when you use the — f dictionary-file option with 
those programs. 

If you have not set the WWBLEV variable, or if it is set to 1, which is the 
default, dictadd prints instructions and prompts with "phrase?". (See the note 
on the wwb manual page to change this default.) If the WWBLEV variable is 
set to s, dictadd does not print instructions and prompts with 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

FILES 

$HOME/lib/wwb/ddict produced by dictadd 

$HOME/lib/wwb/sexdict produced by dictadd 
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$HOME/lib/wwb/spelldict produced by dictadd or spelladd 

$HOME/lib/wwb/tmarkdict produced by dictadd 

SEE ALSO 

consist, diction, proofr, proofvi, sexist, spellwwb, tmark, wwb 
EXAMPLES 

To suppress phrases (that is, make diction, tmark, or sexist stop flagging 
them), you must enter the exact phrase that diction, tmark, or sexist has in its 
standard dictionary. You can take the following steps. 

1. Run diction, tmark, or sexist on a file that contains the phrase you no 
longer want flagged. 

2. Note the sequences of blank spaces and letters that occur between the 
square brackets surrounding the phrase. 

3. When you use dictadd, type in the phrase exactly as it occurs between 
the square brackets, including blank spaces. For example: 

diction output: *[ very]* 
dictadd: phrase? very 
diction output: *[wise]* 
dictadd: phrase?wise 

These blanks are important in limiting or extending the diction, tmark, or 
sexist searches. The standard diction and sexist dictionaries contain the 
phrases as they are bracketed. If the dictionary did not contain the space 
before the "v" in "very," diction would incorrectly flag "every" as well as 
"very." Conversely, if you did type a space before the "w" in "wise," diction 
would miss instances of "wise" added to words to mean concerning, as in 
"saleswise." 

If you want to add more phrases to be flagged by diction, tmark, or sexist you 
should also consider whether to surround them with spaces or not. If, for 
example, you want diction to find words that end in "ize,” do not type a space 
after the prompt. 

phrase?ize 

If you type 

phrase? ize 

diction would only look for words in which "ize" is preceded by a space, in 
effect, words that begin with "ize." 

Spaces after the word or phrase are important also. For example, if you want 
diction to flag all words ending in "ize," but not words with "ize" in the mid- 
dle, type ize with a space after the "e". 

The following sequence will add words to $HOME/lib/wwb/ddict to make 
diction stop flagging the word "very" and start flagging the phrase "bottom 
line." In this scenario, the WWBLEV variable is set to 1. 
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Sdictadd 

Which of these files do you want to make entries in? 

(TO quit at any time, type "q". ) 

1 - $fCHE/lih/w*/ddict 

2 - $H3ffi/lib/wwb/spelldict 

3 - $*ME/lib/wwb/sexdict 

4 - $H3ffi/lih/wvfo/tnarMict 

5 - dictionary-file 

At the prompt, type 1, 2, 3, 4, or 5 
> 1 

This program will first prompt you to enter phrases that are currently 
found by diction that you no longer want it to flag. 

When you have entered all such phrases, type "q" and the program will then 
ask for new phrases to find. That sequence is also ended with a "q" . 

When you see the prompt, "phrase? 11 , type in a phrase you want diction 
to ignore frctn now an. 

Be sure to check the output of diction. If a blank space is needed 
before or after the phrase you want it to ignore, it will be shown 
inside the brackets with the phrase found by diction. For exanple, 

*[ very]* shows there is a blank before the word. 

phrase? very 
phrase? q 

Now when you see the p a r cm p t, type any new words or phrases that you want 
diction to pick up in the future, 
phrase? bottom line 
phrase? q 

Remember that it is important to type in the word or phrase exactly as you 
want the programs to search for them. The words "very" and "bottom" are 
preceded by a space. The blank spaces limit or extend the searches. For ex- 
ample, if "very" did not have a space before it, diction would continue to find 
the word "very.” 
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NAME 

diction — print wordy sentences and suggest substitutions 
SYNOPSIS 

diction [— dlnsOV] [— f dictionary-file] [ — ] [— |/i7e ...] 

DESCRIPTION 

diction locates all sentences in a document that contain phrases from a dic- 
tionary of incorrect or wordy diction and some sexist terms. It prints each 
sentence containing one of the phrases and encloses at least part of the phrase 
with asterisks and brackets (*[ ]*), and it identifies these sentences by line 
number. Then the program prints a Table of Substitutions for the phrases it 
flagged. 

If you have a file named $HOME/lib/wwb/ddict, diction also locates or 
ignores words and phrases contained in that file, dictadd can be used to 
create and update $HOME/lib/wwb/ddict. 

When you give diction multiple input files, it prints the phrases from each 
file and then prints one Table of Suggestions for all the files, diction is one 
of the programs run under the proofr, proofvi, and wwb programs. 

Options are: 

— d Print the pathname of the default diction phrase and substitution 
dictionaries, then exit. 

—1 Produce a long version, printing wordy sentences and a Table of 
Substitutions. This is the default. (You can change this default 
by setting the environmental variable WWBLEV. See the note on 
the manual page for wwb.) 

— n Do not look for phrases in the standard phrase dictionary. When 
used with — f dictionary-file, diction will locate the phrases in 
dictionary-file only. If — n is used without — f dictionary-file, 
diction will locate only the phrases in $HOME/lib/wwb/ddict. 

— s Produce a short version, by excluding the Table of Substitutions. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— f dictionary-file. 

Use the phrase file, dictionary-file, in addition to the standard 
dictionary of incorrect or wordy diction, dictadd can be used to 
set up this file. When the — f dictionary-file, option is used, dic- 
tion does not check $HOME/lib/wwb/ddict for phrases. 

— Delimit the end of options. 

— Use standard input. 

FILES 

/ usr /lib / wwb / dictwords.d 

diction phrase dictionary 

/usr/lib/wwb/dictsugg.d dictionary of substitutions 
/tmp /$$* temporary files used by diction 
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SEE ALSO 

dictadd, proofr, proofvi, sexist, worduse, wwb 

BUGS 

Because diction does not consider context, it may bracket phrases that are 
used appropriately, and it may recommend inappropriate substitutions. It is 
up to you to determine which changes should be made. 

If formatting macros are included in the input text, the beginning line 
number of a sentence containing a bad phrase may be a line containing a 
macro preceding the sentence. 

diction makes no attempt to segment text into sentences accurately; for exam- 
ple, it does not know any abbreviations. 

diction may not find two consecutive bad phrases nor will it always find a 
bad phrase at the end of a sentence. 

EXAMPLE 

$dictian exfile 

diction —1 — f $HCME/lib/wwb/ddict exfile 
beginning line 18 exfile 

P Since the early studies of gopher-resistant materials, an large 
*[ number of ]* new wire, cable, and designs have been developed 
and and many new materials are available. 

beginning line 22 exfile 

The Denver Wildlife and Research Centre (EWRC) and the Bell Telephone 
Laboratories decided to *[ join together]* to test the gopher 
resistance of the new designs. 

beginning line 25 exfile 

The *[ manpower]* for the experiments came from both DWRC and 
BTL; Bell prepared the test samples, took photographs after exposure 
to gophers, and analyzed the engineering implications of the results, 
and the dwrc designed and conducted the exposure test and rated 
the damage to the samples. 

beginning line 36 exfile 

The gophers were not separated *[ as to ]* size or sex. 
file exfile: number of lines 42 number of phrases found 4 
Please wait for the substitution phrases 


Table of Substitutions 


PHRASE 



as 

to: use 

"about, an, of 1 

as 

to: use 

"to” far 

" in i 

as 

to: use 

"to" for 

" so « 

as 

to: use 

"whether" 

for ' 

as 

to: use 

"whether" 

for 1 


StBSTTTUTICN 


as to whether" 
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join together: use " join" far " join together" 

manpower: use "personnel, staff, workers" for " manpower" 

number of: use "enough" for " sufficient number of" 

number of: use "many" for " a large number of" 

number of: use "often" for " in a considerable number of cases" 

number of: use "several, many, sane" for " a number of" 

number of: use "same" for " in a number of cases" 

number of: use "usually" for " except in a stall number of cases" 


EXAMPLE EXPLANATION 

1. The command line shows you want diction to check your text, exfile, 
for any possibly wordy phrases or incorrect word usage. 

2. diction displays the command line, showing that it is using the de- 
fault option, -1, to print wordy sentences and a Table of Substitutions. 
The — f $HOME/lib/wwb/ddict portion of the command line that dic- 
tion displays shows that the dictadd program was used to create a per- 
sonal dictionary of phrases. 

diction will automatically check ddict as well as its own dictionary 
and print sentences from exfile that contain bad or wordy diction or 
suppress phrases as specified in ddict, but it will not print substitu- 
tions for words in ddict. The worduse program can be used to find 
alternatives for the phrases in ddict. 

3. The line number of the sentences where the words or phrases begin is 
given to you, the sentence is printed, and the word or phrase is 
highlighted with asterisks and brackets, for example *[ number of ]*. 

4. diction's output tells you there are 42 lines in your text, and it found 
4 possibly incorrect words or phrases. 

5. The Table of Substitutions is part of the long output. The word or 
phrase is printed, together with its substitution(s). Among the substi- 
tutions for "number of,” diction suggests using "many” instead of "a 
large number of." You should choose the suggestion that is appropri- 
ate for the context of your document. 
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NAME 

diversity — compute a type /token ratio for a document 
SYNOPSIS 

diversity [— dlsOV] [ — ] file ... 

DESCRIPTION 

diversity computes a type/token ratio for a document. The type/token ratio 
is the number of distinct content words in a text divided by the number of 
total content words in the text; it provides a measure of the diversity of the 
language used in the document. Function words, such as "to," "if," "which," 
and "but," serve only to structure a sentence and are not included in the 
analysis. The program explains why diversity in vocabulary is important and 
how the type/token ratio is computed. 

diversity prints a table listing the total number of content words in the input 
file(s) and the type /token ratio for each file. It asks if you want the list of 
distinct content words and the number of times each was used saved in your 
current directory in a file called di .file for each input file, diversity is one of 
the programs run by morestyle. 

Options are: 


-d 

-1 


— s 

-O 

-V 


FILES 

di .file 


Print the full pathname of the diversity dictionary of function 
words, then exit. 

Produce the long version, which includes an explanation of the 
measure of diversity and the table of diversity scores for the 
input file(s). This is the default. (You can change this default by 
setting the environmental variable WWBLEV. See the note on the 
manual page for wwb.) 

Produce a short version, which does not include an explanation 
of the measure of diversity. 

Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

Delimit the end of options. 

contains the list of content words and the 
number of times each occurred 


/usr/lib/wwb/diversity.d contains the dictionary of function words that 

diversity excludes 


SEE ALSO 

morestyle 


EXAMPLE 

Sdiversity exfile 
diversity —1 exfile 

A rich and diverse vocabulary can ireke a text interesting, but 
scms documents (such as procedural directions) demand a small 
vocabulary for effective caimmicatian. Vocabulary diversity can 
be measured with the type/token ratio. 
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The type/token ratio is the number of different words in a text 
divided by the number of total words in the text. Sometimes rather 
than using the total number of words, only the total for content words 
is used. That is what this program does; it excludes connectives 
(or function words) like "an," "but," and "to" frcm its total count. 

The type/token ratio has been used to study how vocabulary changes 
as children grow up, and it can also be used to compare texts. The 
type/token ratio is sensitive to passage length, so when ccmparing one 
passage to another, be sure they are about the same length. 

The type/tcken ratio varies frcm close to 0.0 to 1.0. A text made up 
of the same content word used 10 times with no other words would have a 
ratio of .10. A text with 10 different content words and no other words 
would have a ratio of 1.00. 

There are no standards for type/token ratios. You must examine your 
score and think about hew it relates to the type of document you're 
writing. Further, the type/tcken ratio is very sensitive to the length 
of a passage. Short passages usually yield high diversity scores, 
whereas long passages usually yield relatively low diversity scores. 

If you have a relatively lew type/tcken ratio, such as below .30, it 
could mean that certain words in the text were used too often. You 
can examine the list of words, which will be in di. exfile, to see 
which words you have used most. Changing sane of these words 
could improve the style of your text. However, you should also know 
that in technical material, variation for its own sake makes text more 
difficult to read; synonyms frequently confuse the reader. 

If you have a relatively high typie/token ratio, such as above .60, 
it could mean that the text covers nary different areas, or it could 
mean that you haven't explained each area sufficiently to make it 
understandable. You might want to run the abstract program, abst, 
to see if your papier also seems too abstract. The org program could 
also help you see if your transitions between paragraphs are adequate. 


FILE CONTENT WORDS DIVERSITY 

exfile 156 .80 

The content words in file "exfile" with their frequencies are 
stared in file "di. exfile." Do you want to save it? (y or n) 

>y 

EXAMPLE EXPLANATION 

1. The command line shows you want diversity to compute the 
type /token ratio for your text, exfile. 

2. diversity displays the command line, showing that it is using the de- 
fault option, —1, to produce the long version, which includes an expla- 
nation of the measure of diversity. 
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3. In your file named exfile, there are 156 content words, and your 
type /token ratio is .80. 

4. The program stores the content words and their frequencies in exfile 
in di.exfile, and asks whether to save that file. Type y or n after the 
">" prompt. 
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NAME 

double — find consecutive occurrences of the same word 
SYNOPSIS 

double [-OV] [ — ] [-| file ...] 

DESCRIPTION 

double searches text for consecutive occurrences of the same word. It skips 
text contained in tables formatted with tbl macros and ignores consecutive 
occurrences of any single character except "a". When double finds two words 
in a row, it prints them with the line number of the first double word. 

When you give double multiple input files, it will run on each file separately 
and in sequence, double is one of the programs run under the proofr, 
proofvi, and wwb commands. 

Options are: 

— O Print the command synopsis line (see above) and a short descrip- 
tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— Use standard input. 

Delimit the end of the options. 

SEE ALSO 

proofr, proofvi, tbl, wwb 

BUG 

double will not find double words at the beginning of a sentence if only the 
first one is capitalized. 

EXAMPLE 

$ double exfile 
double exfile 

For file exfile: 

and and appears beginning line 20 

EXAMPLE EXPLANATION 

1. The command line shows you want double to find all consecutive oc- 
currences of words in your file, exfile. 

2. double displays the command line, showing that there are no default 
options. 

3. The output states that the word "and" appears twice beginning on line 
20 of your text. 
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NAME 

findbe — find all forms of the verb "to be" 

SYNOPSIS 

findbe [— OV] [— g format-options] [— r m|n|s] [ — ] [— | file ...] 

DESCRIPTION 

findbe locates forms of the verb "to be" and prints a formatted version of the 
document. If the input text contains mm macros, use the — r m option to for- 
mat the output text with mm. If the input text contains ms macros, use the 
— r s option to format the output text with nroff —ms. The forms of "to be" 
will be capitalized and, depending on the capabilities of your terminal, under- 
lined in the output text. 

If the document is already formatted, use the — r n option. The output text 
will be printed as in the formatted input except findbe will capitalize the 
forms of "to be" (but will not underline them). 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— g format-options 

Give format-options to format the output. (Used only with the 
— r m or — r s options.) 

— r m The input text contains mm macros. The program uses mm to 
format the output. This is the default. (You can change this 
default by setting the environmental variable WWBFMT. See the 
note below.) 

— r n The input text does not contain macros; it is already formatted. 
Print the output text with forms of "to be" capitalized. 

— r s The input text contains ms macros. The program uses nroff —ms 

to format the output. 

— Delimit the end of options. 

— Use standard input. 

USES 

Nominalizations, passives, and expletives make documents difficult to read. 
These language features often force a writer to use a form of the verb "to be." 
findbe makes searching for occurrences of "to be" easier and points out partic- 
ular sections for rewriting. It is recommended for formatting the first draft of 
a paper. 

NOTE 

findbe and continge (with its — c option) format their output with mm by 
default. You can change this default by setting the environmental variable 
WWBFMT and exporting it in your .profile, or you can override the default on 
the command line by typing — r n (the input text is already formatted) or — r s 
(the input text contains ms macros). 

To set the WWBFMT variable, use a UNIX system text editor to edit the .profile 
file in your $HOME directory. If you do not add a WWBFMT variable or set 
WWBFMT-m, findbe and continge assume the input text contains mm macros. 


MANUAL PAGES 3-43 



findbe 


findbe 


and they format their output with mm. If you add WWBFMT— s to your 
.profile, these programs assume the input text contains ms macros, and they 
format their output with nroff —ms. If you add WWBFMT— n, the programs 
assume the input text is already formatted, and they do not reformat the out- 
put. 

You must also export the WWBFMT variable by adding the following line to 
your .profile: 

export WWBFMT 

Again, you can override the default WWBFMT setting at any time on the com- 
mand line. 

SEE ALSO 

mm, nroff, prose, style 

BUG 

findbe will not find two instances of "to be" in a row. 

EXAMPLE 

$findbe exfile 
findbe — r m exfile 


Many biological organisms cause damage to ccnmunicatian 
wires and cables; bacteria, fungi, insects, rodents, and 
marine borers ARE examples. However, the most rapid and 
extensive damage IS caused by various species of rodents. 

As early as 1935 the English reproted rat damage to 
lead sheathed cables, and in 1937 Gertsch reported 71 cases 
of rodent attack to cables. later, Lizell et. al. ran tests 
with caged adult female white rats that WERE given adequate 
food and water. All rubber and plastic materials WERE 

attacked; the harder the material and the larger the sarrple, 
the more difficult it WAS far the animals to cause damage. 

Since the early studies of gopher-resistant materials, 
an large number of new wire, cable, and designs have BEEN 
developed and and many new materials ARE available. The 
Denver Wildlife and Research Centre (EWRC) and the Bell 
Telephone Laboratories decided to join together to test the 

gopher resistance of the new designs. The manpower for the 
experiments came from both EWRC and BTL; Bell prepared the 

test sanples, tock photographs after exposure to gophers, 
and analyzed the engineering implications of the results, 
and the dwrc designed and conducted the exposure test and 

rated the damage to the samples. 

The animals WERE housed in individual cages in a 

standard laboratory bioassay rack. The diet consisted of 

laboratory chow, carrots and occasionally dry alfalfa, but 

no water. The gophers WERE not separated as to size or sex. 

Specimens WERE randomly tested with individual gophers. 
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The natural tendency of gophers to repeatedly chew an 
objects eliminated the need to provide ary incentive such as 
food near the specimens. 

EXAMPLE EXPLANATION 

1. The command line shows you want to locate all forms of the verb "to 
be" in your text, exfile. 

2. findbe displays the command line, showing that it is using the default 
option, — r m, which means the program is using mm to format its 
output. 

3. All forms of the verb "to be" are highlighted with capital letters. On 
some terminal screens, the forms of "to be" may also be underlined. 
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NAME 

gram — find misused articles and split infinitives 
SYNOPSIS 

gram [-OV] [ — ] [-|/i7e ...] 

DESCRIPTION 

gram uses the parts (part of speech assignment) program to find misused arti- 
cles ("a" or "an") and split infinitives ("to quickly run"). When gram lists arti- 
cle errors, that is, words beginning with a pronounced consonant preceded by 
"an" (an monkey) or words beginning with a vowel sound preceded by "a" (a 
elephant), the program gives the approximate line numbers of the errors and 
suggests corrections. 

gram also lists any infinitive that is split by an adverb, which is by far the 
most common type of split infinitive, and gives the approximate line number, 
splitrls gives grammatical information about split infinitives. 

When you give gram multiple input files, it will run on each file separately 
and in sequence, gram is one of the programs run by proofr and wwb. 

Options are: 


— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— Delimit the end of options. 

— Use standard input. 

BUGS 

gram only finds infinitives that are split by adverbs. 

Because parts is not always correct in its assignments, gram may make errors 
in identifying split infinitives. 


SEE ALSO 

parts, proofr, wwb 


EXAMPLE 

$gram exfile 
gram exfile 

Possible grammatical errors: 


In exfile: 

article error: "an large" should be "a large" about line 20 
split infinitive: "to repeatedly chew " about line 41 

For information an split infinitives type: 
splitrls 


EXAMPLE EXPLANATION 

1. The command line shows you want to locate any misused articles and 
split infinitives in your file called exfile. 

2. gram displays the command line, showing that there are no default 
options. 
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3. The output shows that there is one article error and one split 
infinitive. 
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NAME 

match — compare style tables from two or more texts 
SYNOPSIS 

match [-OV] [ — ] [— \style-file ...] 

DESCRIPTION 

match collates selected variables from tables produced by the style command 
and prints values from the different tables, one below the other, for easy com- 
parison. The input files ( style-files ) must contain tables produced by style, 
not ordinary text. You can create style-files by running style on a file (for 
example, style myfile > styl.myfile) or by saving the styl.tmp files produced 
by prose and wwb. 

match can run on just one style-file to produce an abbreviated version of the 
style table, but when comparing texts, it is advisable to use texts of similar 
length. 

match collates the following statistics (which prose discusses) from the style- 
files you name as input: 

■ readability level 

• text length 

■ sentence length 

■ content word length 

■ sentence types 

■ percentage of "to be" constructions 

■ percentage of passive constructions 

■ percentage of verbs and adjectives 

• percentage of nominalizations 

■ percentage of expletives 
Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— Use standard input. 

Delimit the end of the options. 

USES 

This program is useful for comparing stylistic features of different documents 
or drafts and their revisions. 

SEE ALSO 

prose, style 

EXAMPLE 

$match styl.tmpl styl . tmp2 
match styl.tnpl styl.tmp2 
READABILITY 

styl.tnpl: (Kincaid) 13.6 (auto) 14.4 (Coleman-Liau) 13.5 (Flesch) 14.8 (37.9) 
styl.tirp2: (Kincaid) 11.3 (auto) 11.8 (Coleman-Liau) 13.4 (Flesch) 13.8 (44.4) 
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TEXT LENGTH 

styl.tmpl: no. sent 13 no. vds 294 

styl.tmp2: no. sent 16 no. vris 271 

SENTENCE LENGTH 

styl.tmpl: av sent leng 22.6 av word leng 5.20 

styl.tmp2: av sent leng 16.9 av ward leng 5.25 

CONTENT WORD LENGTH 

styl.tmpl: no. content wis 180 61.2% av leng 6.57 

styl.tmp2: no. content wls 174 64.2% av leng 6.51 

SENTENCE TYPES 

styl.tmpl: siitple 23% (3) complex 62% (8) 

styl . tmp2 : simple 44% (7) complex 38% (6) 

styl.tmpl: compound 8% (1) ccnpound-ccrrplex 8% (1) 

styl.tnp2: ccnpound 6% (1) compound-complex 13% (2) 

TOEE USE 

styl.tmpl: tobe 44% (14) aux 13% (4) inf 13% (4) 

styl . tmp2 : tobe 34% (10) aux 14% (4) inf 17% (5) 

PASSIVES 

styl.tmpl: passives as % of non-inf verbs 36% (10) 

styl.tmp2: passives as % of non-inf verbs 25% (6) 

VERBS AND ADJECTIVES 

styl.tmpl: verb types as % of totcil verbs (32) 

styl.tnp2: verb types as % of total verbs (29) 

styl.tmpl: noun 29.3% (86) adj 17.7% (52) pran 3.1% (9) 

styl.tnp2: noun 32.1% (87) adj 19.2% (52) pron 3.0% (8) 

NCMINALIZATIONS 

styl . tnpl : nominalizatians 2 % ( 7 ) 

styl.tnp2: nominalizatians 3 % (7) 

EXPLEHTVES 

styl . tnpl : expletives 8% ( 1 ) 

styl.trrp2: expletives 0% (0) 

EXAMPLE EXPLANATION 

1. The command line shows that you want match to compare the style 
tables in styl.tmpl and styl.tmp2. The prose and wwb commands au- 
tomatically produce a file of statistics called styl.tmp every time it is 
run. If you want to save styl.tmp, change its name or it will be 
overwritten the next time you run prose and wwb. 

2. The headings tell you the subject of the statistics: 

■ readability 

■ text length 

• sentence length 
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■ content word length 

■ sentence types 

■ "to be" use 

■ passives 

• verbs and adjectives 

• nominalizations 

■ expletives 
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NAME 

mkstand — calculate style standards for prose program 
SYNOPSIS 

mkstand [— OV] [— i g|n] [— m m|s] [— o standards-file] [ — ] filel file2 ... 
DESCRIPTION 

mkstand enables you to take documents that you consider to be well written 
to prepare your own set of style standards for use by prose, mkstand com- 
putes stylistic standards that reflect the stylistic features of your documents. 
You can then run prose with the — u o, standards-file option to evaluate docu- 
ments according to your standards. 

mkstand runs style on a set of documents and computes the means and stan- 
dard deviations for the statistics that will be used by prose. From these 
results it computes the standards and puts them into a standards-file 
(stand.out is the default) in a format that prose can read. (This format is 
described in the notes below.) Then if prose is run with the following option 

prose — u o, standards- file file 

it compares file with the standards in standards-file. The command 

prosestnd — u o, standards- file 
will display the standards in a comprehensible form. 

mkstand also writes the individual document scores used in computing the 
standards into a file called styl.scores. This file should be examined for 
unusual scores. 

mkstand tries to ensure valid standards by discouraging the use of short docu- 
ments and documents that are different from the rest of the set. (Short docu- 
ments should only be used if all the input documents are short.) Thus: 

1. Input files should be at least 90 sentences or 1900 words long. If 
any file is not, mkstand will report the length of the file and ask 
whether to include its scores in the calculation of standards. If 
output is directed to a file, mkstand will exclude scores from 
short files without asking, and it will print a message informing 
you both on the standard output and in the file styl.scores. 

2. If an input file has a style score that is more than three standard 
deviations from the mean (an outlier), all scores for that file are 
excluded from the computation of the standards, mkstand prints 
a message informing you both on the standard output and in the 
file styl.scores. 

Standards are most reliable if at least 20 files are used as input to mkstand, 
although there is no minimum requirement. However, the maximum number 
of files it will accept as input is 75. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 
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NOTES 

1 . 


2 . 


3. 


— i g Ignore list items, as defined, by mm macros, in the analysis. This 

is the default. 

— i n Include list items in the analysis. This option should be used if 

the text contains lists of sentences, but not if the text contains 
lists of non-sentences. 

— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 

— m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 

— o standards-file 

Put standards in standards-file instead of the default stand.out. 

— Delimit the end of options. 

If you use formatting header files (which can contain formatting com- 
mands and definitions of macros), include them as part of the input 
text. This is necessary because mkstand runs deroff on files that con- 
tain formatting macros to strip non-sentence text from the input, and 
deroff needs to know about formatting commands you have defined 
yourself in order to interpret them later. If your text files do not con- 
tain formatting commands, run reroff on them yourself, check that the 
reroff output is reasonable, and then use the reroff output as the 
input to mkstand. 

mkstand saves the style scores it uses in computing the standards in a 
file named styl.scores. If any scores in this file seem unusual or 
invalid, rerun mkstand without the unusual document. 

The standards-file that mkstand builds contains 14 lines, one for each 
of the 11 features that prose now considers, and three placeholding 
lines for features that prose may consider in the future. Each line 
contains four numbers for one feature: the mean minus two standard 
deviations, the mean minus one standard deviation, the mean plus one 
standard deviation, and the mean plus two standard deviations. The 
placeholding lines contain four zeroes. The lines are unlabeled, but 
they follow the sequence of style features shown below: 

o Kincaid readability score 
o mean length of content words 
° percentage of short sentences 
o percentage of long sentences 
■ verb /adjective ratio 
o placeholder line 
= placeholder line 
u placeholder line 
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• passive verbs as percentage of non-infinitive verbs 
e percentage of nominalizations 

■ mean sentence length in words 

« percentage of expletives as sentence beginners 

■ percentage of simple sentences minus percentage of complex sen- 
tences 

■ percentage of compound sentences plus percentage of compound- 
complex sentences 

FILES 

/tmp/$$stat.out temporary file containing style tables of input files 

stand-out default output file containing standards 

styl.scores output file containing style scores used in compiling 

standards 

SEE ALSO 

deroff, prose, prosestnd, reroff, style, wwb 
EXAMPLE 

Snikstand -o doc. stands docl dcc2 doc3 doc4 doc5 doc6 doc7 doc8 doc9 docIO doc'll 
doc12 doc13 doc14 doc15 doc16 doc17 doc18 doc19 doc20 

mkstand -m m -i g -o doc -stands docl doc2 doc3 doc4 doc5 doc6 doc7 doc8 doc9 
docIO docll doc12 doc13 doc14 doc15 doc16 doc17 doc18 doc19 doc20 

The mkstand program will new run style on each input file; please wait. 

The mkstand program is running style an the file docl. 

The mkstand program is running style an the file doc2. 

The mkstand program is running style an the file doc3. 

The mkstand program is running style an the file doc4. 

The mkstand pmogram is running style an the file doc5. 

The mkstand program is running style an the file doc6. 

The mkstand program is running style an the file doc7. 

The mkstand program is running style an the file doc8. 

The mkstand program is running style an the file doc9. 

The mkstand program is running style an the file docIO. 

The mkstand program is running style an the file docll. 

The mkstand program is running style an the file doc12. 

The inkstand program is running style an the file doc13. 

The mkstand program is running style an the file doc14. 

The mkstand program is running style an the file doc15. 

The mkstand program is running style an the file doc16. 

The mkstand program is running style an the file doc17. 

The mkstand program is running style an the file doc18. 

The mkstand program is running style an the file doc19. 

The mkstand program is running style cm the file doc20. 

SHORT FILES: 

Files should be at least 1900 wards OR 90 sentences long, 
as corputed by style, for mkstand to ccnpute reliable standards. 

MOTE: Ward counts by the style and wc programs are different. 

— File doc7 has 1453 words and 78 sentences, which is short. 

Do you want to include its scares anyway? (type y or n) : n 
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mkstand will exclude the scores for file doc7. 

— File doc 13 has 528 words and 84 sentences, which is short. 

Do you want to include its scores anyway? (typ:! y or n) : n 

mkstand will exclude the scores for file doc13. 

Since sane files had to be excluded, 
there are no longer 20 files. 

The inkstand program will canpute the standards, 
but they would probably be more reliable 
if you run mkstand again with additional files 
to replace those that were excluded. 

OUTLIERS: 

Files that have style scores more than 3 standard deviations 
from the mean are outliers, which means that they are very 
different frctn the other documents in the set. Therefore, 
outliers will be excluded fran the calculation of the standards. 

— File doc 11 is being excluded, because the following score 
is more than 3 standard deviations fran the mean: 

Percentage of expletives as sentence beginners =7.0 

COMPLETED STANDARDS: 

The style scores used to carpile the standards 
are in a file named styl. scores. Please examine 
this file for any scores that seem unusual or invalid. 

If you find any, rerun mkstand without the unusual 
document. 

Your standards are now in file doc. stands. 

Use prosestnd to look at the standards in a readable way. Type 
prosestnd -u o, doc. stands 

Do not be concerned that same of the lines in doc. stands are all zeros. 
Those zeros are placeholders for variables that prose may consider scmeday. 

You can now use prose to caipare text with the standards in doc. stands, 
by typing the caimand: 

prose -u o, doc. stands file 

where file is the name of a textfile. 
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EXAMPLE EXPLANATION 

1. The command line shows you want to create a personal set of style 
standards against which you can compare your documents. Here, 
doc.stands is the file in which your style standards will be put, 
docl ... doc20 are the names of the input files on which your stan- 
dards will be based. 

2. mkstand is using the default options, — m m and — i g, as it runs on 
exfile. The program will run deroff to eliminate macros and text that 
is not part of sentences, and it will ignore lists in the analysis. 

The — o doc.stands part of the command line shows that mkstand will 
put the new set of standards it is creating in a file called doc.stands 
instead of the default stand.out. 

3. The output tells you how large your input files should be and tells 
you that files doc7 and docl3 are short. It asks you if you want to in- 
clude the scores for these files anyway. Because the response is n, for 
"no," mkstand excludes the scores from doc7 and doc!3 . 

4. mkstand next reports on "outliers"— style scores far from the mean. 
File doc20 has been excluded because its percentage of expletives score 
is more than three standard deviations from the mean. 

5. mkstand puts the style scores for each input document in the 
styl.scores file. 

6. You now have a personal set of style standards. You can look at them 
by typing: prosestnd — u o,doc. stands 

7. The output tells you about the placeholders that appear in doc.stands. 

8. You can now compare your input text to your personal style stan- 
dards. 
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NAME 

morestyle — analyze text by running the abst, diversity, neg, and topic pro- 
grams 

SYNOPSIS 

morestyle [-IsOV] [-i g|n] [-m m|n|s] [reroff-options] [ — ] file ... 

DESCRIPTION 

morestyle runs four stylistic analysis programs: abst, diversity, neg, and topic. 

When you give morestyle multiple input files, it will run abst on each file in 

turn, then run diversity on each file, then neg, and finally topic. 

Options are: 

—1 Produce a long version of the output of the abst, diversity, and 
neg programs. This is the default. (You can change this default 
by setting the environmental variable WWBLEV. See the note on 
the manual page for wwb.) 

— s Produce a short version of the output of the abst, diversity, and 
neg programs. 

— O Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— i g Ignore list items, as defined by mm macros, in the analysis for 
topic. This is the default. 

— i n Include list items in the analysis for topic. This option should be 
used if the text contains lists of sentences but not if the text con- 
tains lists of non-sentences. 

— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 

— m n The input text does not contain macros; it is already formatted. 
The program uses reroff to identify text that is not part of sen- 
tences and eliminates that text from the analysis. 

— m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 

reroff-options 

Use only with the — m n option. 

— h All line-end hyphenated words will retain their hyphens in 

the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if num= 1, double-spaced if num=2, 
triple-spaced if num=3, and so on. 
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—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

Delimit the end of options. 

NOTE 

If you use formatting header files (which can contain formatting commands 
and definitions of macros), include them as part of the input text. This is 
necessary because morestyle runs deroff on files that contain formatting mac- 
ros to strip non-sentence text from the input, and deroff needs to know about 
formatting commands you have defined yourself in order to interpret them 
later. If your text does not contain formatting commands, morestyle can use 
reroff to identify text that should be ignored in the analysis (use the — m n 
option). 

SEE ALSO 

abst, deroff, diversity, neg, prose, reroff, style, topic 

EXAMPLE 

$ morestyle exfile 

morestyle — 1 -i g -m m exfile 

****************************** ABSTRACT WORDS ****************************** 
abst —1 exfile 

Texts differ in the extent to which they refer to concrete 
objects and abstract ideas. Concrete objects, places, or things can 
be seen, heard, felt, smelled, car tasted. Abstract ideas, an the other 
hand, cannot be experienced by our senses. Fran the results of 
psychological research, we know that concrete texts are easier to read, 
easier to use, and easier to remember. 

In file "exfile," 2.2 percent of the words are abstract words, 
which is a good score. 

The abstract words in file "exfile" are stored in file 
"ab. exfile." Do you want to save it? (y or n) 

>y 


****************************** DIVERSITY ****************************** 
diversity —1 exfile 

A rich and diverse vocabulary can make a text interesting, but 
sane documents (such as procedural directions) demand a small 
vocabulary for effective oamumicatian. Vocabulary diversity can 
be measured with the type/tdken ratio. 

The type/taken ratio is the number of different words in a text 
divided by the number of total words in the text. Sonetimes rather 
than using the total number of words, only the total for content words 
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is used. That is what this program does; it excludes connectives 
(or function wards) like "an," "but," and "to" fran its total count. 

The type/tdken ratio has been used to study how vocabulary changes 
as children grow up, and it can also be used to compare texts. The 
type/token ratio is sensitive to passage length, so vA len comparing one 
passage to another, be sure they are about the same length. 

The type/token ratio varies from close to 0.0 to 1.0. A text made up 
of the same content word used 10 times with no other words would have a 
ratio of . 10. A text with 10 different content words and no other words 
would have a ratio of 1.00. 

There are no standards for type/token ratios. You must examine your 
score and think about how it relates to the type of document you're 
writing. Further, the type/tdken ratio is very sensitive to the length 
of a passage. Short passages usually yield high diversity scores, 
whereas long passages usually yield relatively low diversity scores. 

If you have a relatively lew type/token ratio, such as below .30, it 
could mean that certain words in the text were used too often. You 
can examine the list of words, which will be in di. exfile, to see 
which words you have used most. Changing sane of these words 
could improve the style of your text. Hcwever, you should also know 
that in technical material, variation for its cwn sake makes text more 
difficult to read; synonyms frequently confuse the reader. 

If you have a relatively high type/token ratio, such as above .60, 
it could mean that the text covers many different areas, or it could 
mean that you haven't explained each area sufficiently to make it 
understandable . You might want to run the abstract program, abst, 
to see if your papier also seems too abstract. The org program could 
also help you see if your transitions between paragraphs are adequate. 


FILE CONTENT WORDS DIVERSITY 

exfile 156 .80 

The content words in file "exfile" with their frequencies are 
stored in file "di. exfile." Do you want to save it? (y or n) 

>y 


****************************** NEGATIVITY ****************************** 
neg —1 exfile 

Research has shewn that the use of negative words tends to make a 
document more difficult to understand. As a general rule, simple 
affimative sentences are easier to read and comprehend. Double 
negatives, such as "not unrelated," and negative terms such as "unless" 
and "except" should be avoided. 
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In seme circumstances, hewever , negative words nay nake a document 
easier to understand. This is true when the negative word signals a 
change of meaning or corrects a reader's presuppositions. For example, 
when using a new machine or other piece of equipment, the user nay make 
certain assumptions about how the machine works before looking at the 
instructions. In that case, a negative instruction would be 
appropriate when it contradicted what the reader expected. 

The negative program cannot check the content of your document. 

Seme of the negative words used may be appropriate and should not be 
changed. In other cases, the reader may be able to understand the text 
more easily if you eliminate sems of the negative constructions . For 
example, the sentence, "Eight is not an odd number," is better 
expressed as "Eight is an even number." 

In file "exfile," 0.7 percent of the words are negative words, 
which is a good score. 

The following negative words are used in file "exfile": 

1 no 

1 not 

Negative words appear an the following lines of "exfile": 
beginning line 35 exfile 

The diet consisted of laboratory chow, carrots and occasionally 
dry alfalfa, but *[ no ]* water. 

beginning line 36 exfile 

The gophers were *[ not ]* separated as to size or sex. 

file exfile: number of lines 42 number of phrases found 2 

****************************** TOPICS it***************************** 

topic “ m m — i g exfile 
3 gophers 
3 damage 

2 specimens 
2 rodents 

2 dwrc 
2 cables 
2 animals 
1 white 
1 water 

1 various species 
1 took photographs 
1 test samples 
1 sheathed cables 
1 sanples 
1 sample 
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1 rodent attack 
1 results 
1 rat damage 
1 ran tests 
1 plastic materials 


EXAMPLE EXPLANATION 

1. The command line shows you want to use morestyle (which runs 
abst, diversity, neg, and topic) to analyze your file called exfile. 

2. morestyle displays the options it is using. Here, it is using the default 
options, —1, — i g, and — m m, as it runs on exfile. The program will 
produce the long versions of abst, diversity, and neg output, ignore 
list items, and use deroff to eliminate macros and text that is not part 
of sentences. 

3. The output reports the results of running the abst, diversity, neg, and 
topic programs on your text. 

4. abst and diversity store abstract and content words in ab.exfile and 
di.exfile, respectively, and ask if you want to save those files. Type y 
or n after the ">" prompt. 
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NAME 

murky - find difficult sentences in procedural documents 
SYNOPSIS 

murky [-alsOV] [-m m|n|s] [-p c,p,r,cp,cr,pr,cpr] [-R num] 

[reroff-options] [ — ] file ... 

DESCRIPTION 

murky checks sentences in procedural documents for passive verbs, excessive 
sentence and word length, and poorly worded contingencies. It prints sum- 
mary statistics, followed by a Table of Suggestions for each problem sentence, 
murky uses the output from style in its analysis. 

Use murky with procedural text. Applying its suggestions to narrative or 
descriptive text may make that text sound stilted and uninteresting and may 
also make it less cohesive. 

murky uses the Automated Readability Index (ARI) as a cutoff point of the 
acceptability of both sentence and word length. The ARI score provides an 
estimate of grade level readability of the sentence. Since procedural docu- 
ments should use short, simple sentences wherever possible, the default ARI 
value is set equal to a grade level of 10, but this can be changed with the — R 
option. 

murky accepts an option (-p arg) that limits the types of sentences that are 
identified and printed in the Table of Suggestions. The arguments to -p can 
be combined on the command line, separated by commas or separated by 
white space and quoted, to produce various subsets of sentences. 

For example, the command 
murky — p p,c file 

will print sentences that have a passive verb and sentences that have a poorly 
worded contingency. The command 

murky — p cp file 

will print sentences that have both a poorly worded contingency and a pas- 
sive verb. (Not specifying any of the options that identify problem sentences 
is equivalent to specifying — p c,p,r.) 

Options are: 

—a Print all ARI readability scores in the table of problem sentences. 

—1 Produce a long version, including explanations and examples. 
This is the default. (You can change this default by setting the 
environmental variable WWBLEV. See the note on the manual 
page for wwb.) 

— s Produce summary statistics and a Table of Suggestions, but do 

not provide the extended discussion. 

— O Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

-V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 
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— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 

— m n The input text does not contain macros; it is already formatted. 
The program uses reroff to identify text that is not part of sen- 
tences and eliminates that text from the analysis. 

— m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 

— p c Print sentences with poorly worded contingencies. 

— p p Print sentences with passive verbs. 

— p r Print sentences with ARI readability scores above 10 or above the 

cutoff specified by the — R num option. 

— p cp Print sentences that have both poorly worded contingencies and 
passive verbs. 

— p cr Print sentences that have both poorly worded contingencies and 
ARI scores above 10 or above the cutoff specified by the — R num 
option. 

— p pr Print sentences that have both passive verbs and ARI scores above 
10 or above the cutoff specified by the — R num option. 

-p cpr 

Print sentences that have all three types of problems: poorly 
worded contingencies, passive verbs, and ARI scores above 10 or 
above the cutoff specified by the — R num option. 

— R num 

Use num as the ARI cutoff score. 
reroff-options 

Use only with the — m n option. 

— h All line-end hyphenated words will retain their hyphens in 
the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if num= 1 , double-spaced if num= 2 , 
triple-spaced if num= 3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

Delimit the end of options. 
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NOTE 

If you use formatting header files (which can contain formatting commands 
and definitions of macros), include them as part of the input text. This is 
necessary because murky runs deroff on files that contain formatting macros 
to strip non-sentence text from the input, and deroff needs to know about for- 
matting commands you have defined yourself in order to interpret them later. 
If your text does not contain formatting commands, murky can use reroff to 
identify text that should be ignored in the analysis (use the — m n option). 

FILES 

/usr/lib/wwb/prosedoc contains the stored murky output text files 
/tmp/$$* temporary files 

SEE ALSO 

continge, continrls, deroff, mm, nroff, reroff, style 

EXAMPLE 1 

$murky orders 

murky — 1 -m m -R 10 — p c,p,r orders 
For file orders: 

SENTENCES IN PROCEDURAL DOCUMENTS 

NOTE: These guidelines apply to procedural text. 

Applying them to nonprocedural text 
may make that text sound stilted and 
uninteresting . 


PASSIVES 

The text contains 3 sentences (21%) with passive verbs. 

Research shews that active constructions are easier to 
understand than are passive constructions . ("The bey hit the 
ball" is easier than "the ball was hit by the bey".) 

Using an active construction is very important when the 
sentence requires the user to perform an action. If the 
sentence requires a user action, always state the action in 
a sentence starting with the verb. (For example, say "dial 
the number" instead of "the number should be dialed" . ) 

Sentences containing passive verbs are narked in the table 
of suggestions with a "P" in the "make active" column. 
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Use the following guidelines for each sentence narked "P": 


IF the sentence 

THEN 

requires the user 
to perform an action 

change the sentence 
to imperative form 
beginning with the verb 

does not require 
the user to perform 

an action 

change the passive verb 
to an active verb 
wherever possible 


SENTENCE AND WCRD LEN3TH 

The text contains 5 sentences (35%) with an Autcmated 
Readability Index (ARI) greater than 10. 

The ARI score, which depends an both sentence and word length, 
provides a rough estimate of grade level readability of the 
sentence. Of course, not all these sentences will be difficult 
to read, but examine each one to see if you can improve it. 

Lock at the sentences with a letter in the second or third column 
of the table of suggestions. Overly long sentences have a letter 
in the second ("make shorter") column. Sentences with a "W" in 
the third ("check long wds") column have a high mean word length. 

I . Lang Sentences 

o You can improve sane long sentences by dividing them 
into two or more shorter sentences. Far exanple: 

Before: The Z-16 circuit pack is enclosed in a 
molded plastic housing with a metallic 
baseplate that is designed for indoor 
mounting only. 

After: The Z-16 circuit pack is enclosed in a 
molded plastic housing with a metallic 
baseplate. The housing is designed for 
indoor mounting only. 

o Another caution way to improve long sentences is to 
list the elements in the sentence. For exanple: 

Before: The subscriber grouping consists of LC49 or 
LC50 circuit packs with internal battery at 
the derived customer premises and an 
external filter at the physical customer 
drop. 
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After: The subscriber grouping consists of: 

o LC49 or LC50 circuit packs 

o the internal battery at the derived 
customer premises 

o an external filter at the physical 
customer drop. 

o The letter in the "make shorter" column is a 
suggestion of which type of change to try first. 

- IF the letter is a "D", THEN first try dividing 
the sentence into two or more shorter sentences. 

- IF the letter is a "L", THEN first try listing 
the elements of the sentence. 

II. High Mean Word Length 

Sentences with a "W" in the third column have a high mean 
word length. Often, this means that you can improve the 
choice of words in the sentence. 

o Check the long words in the sentence. If possible, 
substitute a shorter, more familiar word. For 
example: 

Before: Utilize moisture to extinguish the 
conflagration. 

After: Use water to put out the fire. 

o If you cannot substitute a more familiar word, then 
define words that may be unfamiliar to the reader. 

For example: 

Before: Many gardeners believe that the best 
general fertilizer is caipost. 

After: Many gardeners believe that the best 
general fertilizer is compost, which 
consists largely of decaying organic 
material . 
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o Change naninalizations to verbs. Naninalizations are 
nouns that are derived frctn verbs. They usually end 
in "ion" or "ment." In the table of suggestions, 
naninalizations are preceded and followed by an 
asterisk. Eliminating naninalizations often improves 
the sentence. For example: 

Before: The following paragraphs provide a 

♦description* of the system *pperatian*. 

After: The following paragraphs describe how the 
system operates. 

o Check that there are enough articles (a, an, the), 
relative pronouns (that, which) , and prepositions (of, 
in, on, etc. ) to make the meaning of the sentence 
clear . For exairple : 

Before: Stencil the number on ignition element 
aluminum housing. 

After: Stencil the number an the aluminum housing 
of the ignition element. 


CONTINGIECIES 

The text contains 3 sentences (21%) that may involve contingencies 
that are not clearly stated. 

(A contingency is a case in which an action depends an 
the state of a previous condition or conditions. ) 

Examine each sentence with a "C" in the last ( "check if-then" ) column 
of the table of suggestions to see if it involves a contingency. 

You can improve those sentences that involve contingencies by 
rewriting them into more explicit IF-THEN sentences. For 
exairple: 

Before: Fill in the information on Form B unless you are under 
18 years of age. 

After: If you are 18 years of age or older, then fill in tire 
information an Form B. 

Use the "cantinge" program to obtain a more detailed discussion 
of the contingencies in this text. 
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1 TABLE OF SUGGESTIONS FOR SIMPLIFYING SENTENCES ! 

1 1 




C 





H 

C ! 



s 

E 

H ! 


M 

H 
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E ! 


A 

0 

K 

c ! 


K 
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E 

T 

L 




E 

0 

I ! 


A 

N 

N 

F ! 


c 


G 

- ! 


T 

s 


T ! 


I 

E 

W 

H i 


V 

N 

D 

e : 

Sentence 

E 

T 

s 

N ! 

when the pao establishes an order with a " hot " status 
— that is , one needing imnediate *attention* — or 
one with frame due date of today or tomorrow a bell 
rings at the frame ; *transactian* for is then used to 
obtain this order . 


D 


c ! 

the order number , order type , and any related order 
numbers are given along with the facilities listed in 
schematic order . 

P 

L 

W 


occasionally , a new connect service order will not be 
able to use the line *equipment* associated with a dip 
ed cable pair ; in these cases , send a message to the 
frame to break the dip . 


D 


c ! 

send a separate order to connect the new circuit , and 
list any special , required security *protection* . 



W 


in all cases , if the frame output is next requested , 
then notify the Frame . 

P 




a service order is normally cancelled in anonymos when it 





is the result of a customer request . 

P 



c ! 

you can change a service order through an *assignment* 
change ticket , a service order *modificatian* , ar a 
change-of -due-date . 



w 



TABLE REST: C. .Contingency 
D. .Divide 
L. .List 

P. .Passive verb 
W. .Words 
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EXAMPLE 1 EXPLANATION 

1. The command line shows you want to check your procedural text, 
orders, for passive sentences, sentences that are too long or have too 
many long words, and poorly worded contingencies. 

2. murky displays the options it is using. Here, it is using the default 
options, —1, — m m, — R 10, and — p c,p,r as it runs on orders. The pro- 
gram will produce the long version of output and use deroff to elim- 
inate macros and text that is not part of sentences. It will look for 
sentences with poorly worded contingencies, those with an Automat- 
ed Readability Index (ARI) of 10 or greater than 10, and those with 
passive verbs. 

3. The program notes that it is suitable for use with procedural text. 

4. murky tells you orders contains 3 passive sentences, which is 21% of 
your text, and presents a discussion on active and passive voice. 

5. murky next reports that 5 sentences in orders have an Automated 
Readability Index (ARI) greater than 10. This information is followed 
by discussions on long sentences and high mean word length. 

6. The third phase of murky's analysis is on contingencies, orders con- 
tains 3 sentences that present poorly worded contingencies. 

7. A short explanation on contingencies is followed by a Table of 
Suggestions for simplifying the sentences in your text. The words en- 
closed in asterisks in the table are nominalizations. 

EXAMPLE 2 

The command 

murky — s orders 

produces only summary statistics and a Table of Suggestions. 

EXAMPLE 3 

The command 

murky — R 8 — m s orders 

assumes text formatted with ms macros. It prints summary statistics, an ex- 
tended discussion, and a Table of Suggestions using an Automated Readability 
Index (ARI) cutoff value equal to a grade level of 8. 

EXAMPLE 4 

The command 

murky — s — R 16 — p cp,pr,rc orders 

produces limited output. The Table of Suggestions shows only sentences that 
have at least two types of problems (— p cp,pr,rc). The ARI cutoff is set at a 
score of 16. The options used on this command line identify sentences that 
may be very difficult to understand. 
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NAME 

neg — find negative words 
SYNOPSIS 

neg [— dlsOV] [ — ] file ... 

DESCRIPTION 

neg finds the words in the input text that occur in a dictionary of negative 
words. It compares the percentage of negative words in the document with 
standards and, with the —1 option, lists the negative words and the number of 
times each occurs. The program also prints the sentences that contain nega- 
tive words with the negative words enclosed in asterisks and brackets (*[ ]*). 

When you give neg multiple input files, it will print the discussion of nega- 
tive words only once, followed by the output for each file in sequence, neg is 
one of the programs that is run by morestyle. 

Options are: 

-d 

-1 


— s 


-O 
-V 

FILES 

/usr/lib/wwb/neg.d dictionary of negative words 

ne.file contains the negative words and the number of times 

each occurs 

SEE ALSO 

morestyle 

EXAMPLE 

$neg exfile 
neg —1 exfile 

Research has shown that the use of negative words tends to make a 
document more difficult to understand. As a general rule, simple 
affirmative sentences are easier to read and canprehend. Double 


Print the full pathname of the neg dictionary of negative terms, 
then exit. 

Produce a long version, which explains why negative construc- 
tions are difficult to understand, gives the percentage of negative 
words in the input text, states how that percentage compares 
with standards, lists the negative words used in the input text, 
and prints sentences containing negative words. This is the 
default. (You can change this default by setting the environmen- 
tal variable WWBLEV. See the note on the manual page for 
wwb.) 

Produce a short version, which gives the percentage of negative 
words in the input text and states how that percentage compares 
with standards. With the — s option, neg asks if you want to save 
the list of negative words in your current directory in a file 
called ne.file. 

Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

Delimit the end of options. 
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negatives, such as "not unrelated," and negative terms such as "unless" 
and "except" should be avoided. 

In sane circumstances, however, negative words may make a document 
easier to understand. This is true when the negative word signals a 
change of meaning or corrects a reader's presuppositions. For example, 
when using a new machine or other piece of equipment, the user may make 
certain assumptions about how the nachine works before looking at the 
instructions. In that case, a negative instruction would be 
appropriate when it contradicted what the reader expected. 

The negative program cannot check the content of your document. 

Seme of the negative words used nay be appropriate and should not be 
changed. In other cases, the reader nay be able to urxier stand the text 
more easily if you eliminate seme of the negative constructions. For 
example, the sentence, "Eight is not an odd number," is better 
expressed as "Eight is an even number." 

In file "exfile," 0.7 percent of the words are negative words, 
which is a good score. 

The following negative words are used in file "exfile": 

1 no 
1 not 

Negative words appear an the following lines of "exfile": 
beginning line 35 exfile 

The diet consisted of laboratory chow, carrots and occasionally 
dry alfalfa, but *[ no ]* water. 

beginning line 36 exfile 

The gophers were *[ not ]* separated as to size or sex. 
file exfile: number of lines 42 number of pihrases found 2 

EXAMPLE EXPLANATION 

1. The command line shows you want to locate negative words in your 
file called exfile. 

2. neg displays the options it is using. Here, it is using the default, — 1, 
to produce the long version of output. 

3. The output explains why negative constructions are difficult to under- 
stand. 

4. neg reports that 0.7 percent of exfile's words are negative, which is a 
good score, and shows the negative words and how many times they 
appear. 
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5. The output also gives the beginning line number of the sentences that 
contain a negative word and prints the sentence. Each negative is sur- 
rounded by asterisks and brackets, for example, *[ no ]*. 

6. neg reports there are 42 lines in exfile, and it found 2 negative words. 
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NAME 

org — show the organization of a document 
SYNOPSIS 

org [— OV] [— g format-options] [— r m|n] [reroff-options] [ — ] [— \file ...] 
DESCRIPTION 

org shows the organization of a document by printing a condensed version: 
the headings and the first and last sentence of each paragraph, org uses the 
mm heading (.H) and paragraph (.P) macros to identify heading and para- 
graph boundaries. The program skips displays, tables, lists, footnotes, and 
equations. 

If the input text does not contain mm macros, org can use reroff on a format- 
ted file to identify the headings and paragraph boundaries. The input text 
must contain standard mm macros, or it must be already formatted, in which 
case you should specify the — r n option on the command line so the program 
will use reroff to identify headings and paragraph boundaries. This program 
does not work on files with ms macros. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— g format-options 

Give format-options to mm to format the output. 

— r m The input text contains mm macros, which org will use to iden- 
tify headings and paragraph boundaries and to format the out- 
put. This is the default. (You can change this default by setting 
the environmental variable WWBFMT. See the note on the 
manual page for wwb.) 

— r n The input text does not contain macros; it is already formatted. 

The program uses reroff to identify the headings and paragraph 
boundaries and then uses mm to format the output. 

reroff-options 

Use only with the — r n option. 

— h All line-end hyphenated words will retain their hyphens in 

the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if num=l, double-spaced if num= 2, 
triple-spaced if num— 3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 
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— Delimit the end of options. 

— Use standard input. 

NOTE 

If you use formatting header files (which can contain formatting commands 
and definitions of macros), include them as part of the input text. If your text 
does not contain mm macros, and it is already formatted, you can run reroff 
to identify text that should be ignored in the analysis (use the — r n option). 

USES 

The output can be used to study the general organization of the input text 
and the transition between paragraphs; sometimes it can be a good abstract. 

SEE ALSO 

mm, reroff 

BUGS 

The input text must contain standard mm macros or be already formatted so 
reroff can put in the macros. 

org will not recognize common abbreviations at the end of a sentence as the 
sentence end; consequently, more than two sentences may be printed for a 
paragraph. 

EXAMPLE 

$org -g T450 preface 
org -r m -g T450 preface 
org -r m -g T450 preface 


Overview of the Manual 

The UNIX WRITER'S WORKBENCH Software is a set of programs 
that helps experienced and inexperienced writers and editors 
evaluate and revise documents. This manual provides 
detailed instructions for using the WRITER'S WORKBENCH 
programs in the UNIX system environment. 

This user's guide contains three descriptive chapters, an 
appendix, a glossary, a bibliography, and an index. A 
reference card that summarizes the WRITER'S WORKBENCH 
programs and features is also available. 

Chapter 1, "Getting Started," provides information about 
using the WRITER'S WORKBENCH programs in the UNIX system 
environment. There is also a detailed section on using 
deroff for text with formatting macros and reroff for text 
that is already formatted. 

Chapter 2, "A Tutorial Introduction to the WRITER'S 
WORKBENCH System," is divided into three exercises that lead 
you through typical work sessions and teach you how to enter 
cccrmands, interpret the output, and make corrections to your 
text using the suggestions provided by the programs. The 
third exercise covers proofvi, the new interactive 
proofreading program. 
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Chapter 3, "The WRITER'S WORKBENCH Manual Pages," is a 
reference section that presents a manual page for each 
program. Manual pages include the ccnnand line synopsis, a 
description of the cartmand, definitions of the available 
options and arguments, lists of related programs, and 
examples. 

Appendix A contains a papier by Nina H. Macdonald that 
describes the rhetorical and psychological writing 
principles that underlie the WRITER'S WORKBENCH programs. 

The Glossary defines many of the terms appearing in this 
user's guide, including ccnputer and UNIX system terms, all 
WRITER'S WORKBENCH programs, statistical terms, and 
grammatical, writing, and editing terms. 

The Bibliography contains references that nay be useful to 
you both for writing and editing and for a better 
understanding of the WRITER'S WCKKBEtKH programs and the 
UNIX system. 

The Index lists the page numbers where information on 
keywords can be found. 

Type Styles Used in this Manual 

Four different type styles are used in this manual: . 

How to Check Your Access to the WRITER'S WORKBENCH System 

Release 3.0 of the WRITER'S WORKBENCH system runs on UNIX 
System Research Version 7 and its derivatives, as well as an 
UNIX System V Release 2.0 and higher. If you have a version 
number that starts with 2.0, you do not have the release 
that matches this documentation; you have the previous 
release . 

If the system responds something like call your UNIX system 
administrator or ccnputer center to ask if the WRITER'S 
WORKBENCH system is available and what the full pathname is 
for the directory in which the programs are stored. Your 
system administrator can help you add the correct pathname 
to your so that you will be able to access the WRITER'S 
WORKBENCH system. 


EXAMPLE EXPLANATION 

1. The command line shows you want org to format your text, preface, 
and print the first and last sentences of the paragraphs in your text, as 
well as any headings. The formatting option, — g T450, prepares the 
output for the specified terminal type. 
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2. org displays the options it is using. Here it is using the default op- 
tion, — r m, to format the output with mm and the — g T450 formatting 
option. 

3. The entire output is composed of headings, together with the first and 
last sentences for all text paragraphs. Section 1.1 contains a list, but 
org does not print lists. 
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NAME 

parts — assign parts of speech 
SYNOPSIS 

parts [-wOV] [-i g|n] [-m m|n|s] [reroff-options] [ — ] [-|/i7e ...] 
DESCRIPTION 

parts assigns words to one of thirteen word classes: noun, verb, article, adjec- 
tive, adverb, conjunction, preposition, interjection, auxiliary verb, pronoun, 
subordinate conjunction, to be, and possessive, parts uses a dictionary of 
function words, irregular verb forms, and word endings to classify many of 
the words. It then classifies the remaining words by looking for relations 
between them. (See the note on this manual page for a more detailed descrip- 
tion of the parts algorithm.) 

By default, parts prints words from the input text in lines of continuous text. 
The part of speech is printed below each word. The output format can be 
altered to print one word per line with the — w option. When you give parts 
multiple input files, it will run on each file separately and in sequence. 

Since parts uses word endings to identify most verbs, it cannot recognize an 
imperative verb unless the sentence containing it is marked. A tilde (') 
immediately before the period (no space between them) tells parts the sen- 
tence is imperative. For example, parts will correctly label "unplug'' as a verb 
in this sentence: 

Unplug the coffee pot*. 

Without the tilde, parts would call "unplug" a noun. 

Options are: 

— w Print output one word per line, with a tab between the word and 

the part of speech. 

— O Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— i g Ignore list items, as defined by mm macros, in the analysis. This 
is the default. 

— i n Include list items in the analysis. This option should be used if 
the text contains lists of sentences but not if the text contains 
lists of non-sentences. 

— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 

— m n The input text does not contain macros; it is already formatted. 
The program uses reroff to identify text that is not part of sen- 
tences and eliminates that text from the analysis. 

— m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 
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reroff-options 

Use only with the — m n option. 

— h All line-end hyphenated words will retain their hyphens in 

the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if num= 1, double-spaced if nafli=2, 
triple-spaced if num= 3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 


— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

Delimit the end of options. 

Use standard input. 


NOTES 

If you use formatting header files (which can contain formatting commands 
and definitions of macros), include them as part of the input text. This is 
necessary because parts runs deroff on files that contain formatting macros to 
strip non-sentence text from the input, and deroff needs to know about for- 
matting commands you have defined yourself in order to interpret them later. 
If your text does not contain formatting commands, parts can use reroff to 
identify text that should be ignored in the analysis (use the — m n option). 

parts first runs deroff to remove formatting commands and associated text 
that are not part of sentences from the text. Then parts runs three programs 
to assign parts of speech to the remaining words. 

The first program identifies words as strings of characters separated by blanks 
and punctuation marks. It identifies sentences as strings of words followed by 
periods question marks, or exclamation points. (It references a dictionary of 
standard abbreviations to exclude them.) Then the program looks up each 
word and classifies those found in a small dictionary of function words and 
irregular verbs. 

The second program looks at the words that were not assigned a word class 
by the first program and assigns parts of speech by matching suffixes. 

The third program assigns word classes to the remaining words by looking for 
a verb and a subject. It then applies rules of English sentence construction to 
make final assignments. 


SEE ALSO 

deroff, prose, reroff, style, wwb 

BUG 

English grammar is complex, so parts makes some mistakes. It is about 95% 
accurate. 
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EXAMPLE 1 

$parts exfile 

parts -m m -i g exfile 

many biological organisms cause damage to ccmnunicaticn wires 

adj adj noun verb noun prep adj noun 

and cables ; bacteria , fungi , insects , rodents , and 

canj noun ; noun , noun , noun , noun , canj 

marine borers are examples . however , the most rapid and 

adj noun be noun . adv , art adj noun canj 


extensive 

damge 

is 

caused 

by 

various 

species 

of 

rodents 

adj 


noun 

be 

verb 

prep 

adj 

noun 

prep 

noun 

as 

early 

as 

1935 

the 

English 

reproted rat 

damage 

to 

adv 

adv 

canj 

noun 

art 

noun 

verb 

adj 

noun 

verb 


lead sheathed cables , and in 1937 Gertsch reported 71 


verb 

adj 

noun , 


canj 

prep adj 

noun 

verb adj 

cases 

of 

rodent attack 

to 

cables 

. later , 

Lizell et 

noun 

prep 

adj noun 


prep 

noun 

. adv 

» 

noun verb 

were 

given 

adequate food 

and 

water 

all 

rubber 

and 

be 

verb 

adj noun 

canj 

noun 

adj 

noun 

canj 

plastic materials were 

attacked 

; the 

harder 

the 

material and 

adj 

noun 

be 

verb 

; art 

noun 

art 

noun canj 

the 

larger 

the sample 


, the 

more difficult 

it 

was for 

art 

noun 

art noun 


, art 

adj noun 

pran 

be prep 

the 

animals 

to cause 


damage 

. since the 

early 

studies of 

art 

noun 

verb verb 


noun 

prep 

art 

adj 

noun prep 

gopher-resistant materials 


, an 

large 

number 

of 

new wire , 

adj 


noun 


, art 

adj 

noun 

prep 

adj noun , 

cable 

, and designs 

have been developed and and many new 

noun 

, canj noun 

aux be 

verb 

canj canj adj adj 

materials are available 


the 

Denver 

Wildlife 

and 

Research 

noun 

be 

adj 


art 

adj 

noun 

canj 

adj 

Centre ( dwrc ) and 


the Bell Telephone laboratories decided 

noun 

( noun ) canj 


art adj adj 

noun 

verb 
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EXAMPLE 1 EXPLANATION 

1. The command line shows you want to find out the parts of speech for 
all the words in your text file named exfile. 

2. parts displays the command line, showing that it is using the default 
options, — m m and — i g, as it runs on exfile. The program will run 
deroff to eliminate macros and text that is not part of sentences, and it 
will ignore lists in its analysis. 

3. The output includes the sentences in exfile with the part of speech for 
each word printed below (not all output is shown in this example). 

EXAMPLE 2 

The command: 

parts — w — i n exfile 

will print each word from the input text, including words in lists, one word 

per line. The part of speech will be printed beside each word. 
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NAME 

proofr, proofer — run five proofreading programs (spellwwb, punct, double, 
diction, and gram) 

SYNOPSIS 

proofr [— IsOV] [ — ] file ... 

DESCRIPTION 

proofr is an automatic proofreading program that runs five other programs: 

1. spellwwb checks for misspelled words. 

2. punct checks for rudimentary punctuation errors. 

3. double searches for consecutive occurrences of the same word. 

4. diction locates wordy or misused phrases and suggests alterna- 
tives. 

5. gram finds split infinitives and improperly used articles. 

When you give proofr multiple input files, it will run spellwwb on each file 
in turn, then run punct on each file, then double, then diction, and finally 
gram. 

proofr is one of the programs run by the wwb command, proofr is also run 
by proofvi, which provides interactive correction capabilities (for all proofr 
programs except gram). 

Options are: 

—1 Produce a long version. This is the default. (You can change 
this default by setting the environmental variable WWBLEV. See 
the note on the manual page for wwb.) 

— s Produce a short summary version of the output. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— Delimit the end of options. 

NOTE 

If you have a file called $HOME/lib/wwb/ddict, proofr will run diction so 
that phrases in ddict are located or ignored, as specified. See diction and dic- 
tadd for more information. 


If you have a file called $HOME/lib/wwb/spelldict, proofr will run 
spellwwb so that words in spelldict are not listed as errors. See dictadd, 
spelladd, and spellwwb for more information. 

FILES 

/tmp/$$* temporary files 

SEE ALSO 

deroff, dictadd, diction, double, gram, parts, proofvi, punct, spelladd, spell- 
tell, spellwwb, worduse, wwb 

BUGS 

See other manual pages for bugs in individual programs. 
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EXAMPLE 

Sproofr exfile 
proofr —1 exfile 

****************************** SPELLING ******************************* 

Possible spelling errors in exfile are: 

Centre Lizell 

DWRC al 

Gertsch 

If any of these words are spelled correctly, later type 
spelladd wordl word2 . . . wordn 
to have them added to your spelldict file. 


dwrc 

reproted 


***************************** PUNCTUATION ***************************** 
The punctuation in exfile is first described. 

0 double quotes and 0 single quotes 

0 apostrophes 

1 left parentheses and 1 right ones 

The program next prints any sentence that it thinks is 
incorrectly punctuated and follows it by its correction. 


line 13 

OLD: of rodent attack to cables. 
NEW: of rodent attack to cables. 


later, Lizell et. al. ran tests 
later, Lizell et al. ran tests 


For more information about punctuation rules, type: 

punctrls 

***************************** DOUBLE WORDS **************************** 
For file exfile: 

and and appears beginning line 20 


***************************** WORD CHOICE ***************************** 

Sentences with possibly wordy or misused phrases are listed next, 
followed by suggested revisions. 

NOTE: proofr is using your file $HCME/lib/wwfo/ddict for additional phrases. 
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beginning line 18 exfile 

P Since the early studies of gopher-resistant materials, an large 
*[ number of ]* new wire, cable, and designs have been developed 
and and many new materials are available. 

beginning line 22 exfile 

The Denver Wildlife and Research Centre (DWRC) and the Bell Telephone 
Laboratories decided to *[ join together]* to test the gopher 
resistance of the new designs. 

beginning line 25 exfile 

The *[ manpower]* for the experiments came from both IWRC and 
BTL; Bell prepared the test samples, took photographs after exposure 
to gophers, and analyzed the engineering implications of the results, 
and the dwrc designed and conducted the exposure test and rated 
the damage to the samples. 

beginning line 36 exfile 

The gophers were not separated *[ as to ]* size or sex. 
file exfile: number of lines 42 number of phrases found 4 
Please wait for the substitution phrases. 


Table of Substitutions 


PHRASE 


SUBSTITUTION 


as to: use "about, an, of" for " as to" 

as to: use "to" for " in such a way as to" 

as to: use "to" for " so as to" 

as to: use "whether" for " as to whether" 

as to: use "whether" for " the question as to whether" 

join together: use " join" for " join together" 

manpower: use "personnel, staff, workers" for " manpower" 

number of: use "enough" for " sufficient number of" 

number of: use "many" for " a large number of" 

number of: use "often" for " in a considerable number of cases" 

number of: use "several, many, same" for " a number of" 

number of: use "same" for " in a number of cases" 

number of: use "usually" for " except in a small number of cases" 


* Not all the revisions will be appropriate for your document. 

* When there is more than one suggestion for just one bracketed 
word, you will have to choose the case that fits your use. 

* Capitalized words are instructions, not suggestions. 

* To find out more about each phrase, type "worduse phrase." 
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NOTE: If you want this program to look for additional phrases 
or to stop looking for seme, for instance to stop 
flagging "inpact," type the command dictadd. 


****************************** GRAMMAR ******************************* 

Possible gramratical errors: 

In exfile: 

article error: "an large" should be "a large" about line 19 
split infinitive: "to repeatedly chew " about line 38 

For information an split infinitives type: 

splitrls 

EXAMPLE EXPLANATION 

1. The command line shows you want to have your input text, exfile, 
proofread. The proofr program runs spellwwb, punct, double, dic- 
tion, and gram on the file. 

2. proofr displays the options it is using. Here, it is using the default 
option, —1, to produce the long version of output. 

3. proofr runs spellwwb and lists all the words it could not find in its 
dictionary. Later, you can use spelladd or dictadd to add names 
(Lizell and Gertsch) and acronyms (DWRC) to your personal spelling 
dictionary. 

4. Punctuation in the text is described and then lines from the input file 
with potential errors are printed after OLD:. The program prints its 
correction of the line after NEW:. It capitalized the "1" in "later" and 
removed the period after "et." 

5. proofr located one occurrence of double words: "and and" beginning 
on line 20. 

6. Sentences with possibly wordy or misused phrases are listed, with 
their beginning line number, in the WORD CHOICE section, for exam- 
ple, *[ number of ]*. The note shows that you have used the dictadd 
program to create a personal dictionary of phrases, diction, which is 
run by proofr, will automatically check ddict and print sentences from 
exfile that contain bad or wordy diction or suppress phrases as you 
have specified in ddict. 

The Table of Substitutions gives you alternatives to the words or 
phrases you may not have used correctly. An alternative to "a large 
number of" is "many." 

7. Possible misused articles and split infinitives in exfile are listed, and 
the program recommends using splitrls, which provides on-line infor- 
mation about split infinitives. 
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NAME 

proofvi — run four proofreading programs (spellwwb, punct, double, and dic- 
tion) and provide interactive error correction 

SYNOPSIS 

proofvi [— erOV] [— f reference-file] [ — ] file ... 

DESCRIPTION 

proofvi is an interactive proofreading program that runs four other programs: 

1. spellwwb checks for misspelled words. 

2. punct checks for rudimentary punctuation errors. 

3. double searches for consecutive occurrences of the same word. 

4. diction locates wordy or misused phrases and suggests alterna- 
tives. 

(See the proofvi exercise in the WRITER'S WORKBENCH Software User's Guide). 

By default, proofvi works in two stages. You can run the first stage by typ- 
ing: 


proofvi file 

The program will run each of the four proofreading programs in sequence in 
the background, locating and saving the errors in a reference file. When stage 
one is finished, proofvi sends mail that you can run stage two. Again, type: 

proofvi file 

The — e option overrides the two-stage default by running the first stage in 
the foreground and then running the interactive session as soon as the first 
stage is complete. 

During the second stage, you can make corrections to your file using the 
interactive corrector, proofvi splits the screen into three sections: 

1. The top section displays the input file with proofreading errors 
highlighted. 

2. In the middle section, proofvi presents menus that provide 
information about the current error, suggests possible correc- 
tions, and helps you make corrections, in some cases global 
corrections. You can choose a menu option, make a change 
using a set of editing commands, or skip over the error. 

3. The third section, a line at the bottom of the screen, provides 
editing status information. In addition, any colon commands 
that you type will appear in this section. 

proofvi uses an editor based on vi; the editing commands are listed in note 3 
below. 

The output of stage one is a reference file, named ref. file, which lists the line 
and column numbers of all the errors found in the input text. If you change 
the name of this file, the new name must be given as an argument after the 
— f option when you run the second stage to make corrections. 
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During an editing session, one error in the top window is the current error. 
You can move the cursor away from the current error, but proofvi will still 
consider that error to be the current one. The Ctrl-R sequence will return the 
cursor to the current error. The Ctrl-N sequence will move the cursor to the 
next error, which will become the current error. To view the on-line help 
facility, type :h any time you are not in input or add mode or using the spel- 
ling corrector. 

When you type :w to save your work during an editing session, a copy of the 
changed file is saved in sv.file and a current reference file of remaining errors 
is saved in svret.file. If the computer system crashes, use the command: 

proofvi — r file 

proofvi will check to see if the files sv.file and svref. file exist. They will if 
you have used :w during the editing session; proofvi will resume the editing 
session from the point you typed :w. If the save files do not exist, proofvi 
will check for i.file, where there may be some recoverable work. 

proofvi writes the changes you make to i.file as you edit. Therefore, i .file is 
constantly growing as you move through the file, until it contains a complete, 
revised copy of your file when you are done. You will only be aware of this 
file if the system crashes and you type proofvi — r file. If your file is longer 
than 32 lines and you have changes through about 50 lines in the file so that 
the i.file contains changed text, the — r (recover) option will provide instruc- 
tions. 

When proofvi is invoked with more than one input file, it will create a refer- 
ence file for each input file. You cannot use multiple files with the — f option. 
When multiple files are given with the — e option, proofvi will rerun itself 
and allow you to correct errors interactively for each file in turn. 

Options are: 

— e Run proofvi in interactive editing mode, proofvi will find 

proofreading errors in the input text and store them in rei.file. 
It will print messages on the screen to tell you which of the four 
proofreading programs it is running, and once the reference file 
is complete, proofvi will run in its interactive editing mode. 
When you use the — e option, proofvi does not check if rei.file 
already exists, it automatically creates a new one. 

— r Recover an editing session that was interrupted by a system 

crash. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— f reference-file 

Use the reference-file in the interactive mode as the reference 
file containing the locations and types of errors, reference-file 
can be a renamed reference file left from a previous proofvi ses- 
sion that was quit before all the errors were corrected. If the 
reference file was not renamed, it need not be specified after the 
— f option because proofvi checks for rei.file automatically. 
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However, if rei.file is not in the current directory, the full path- 
name must be specified after the — f option. 

Delimit the end of options. 


FILES 


rei.file 

contains the type and location of errors found by 

proofvi 

i.file 

contains the edited part of your file; may contain some 
recoverable work after a system crash 

sv.file 

created with :w, contains a copy of the edited text file 

svref./ife 

created with :w, contains a copy of the current refer- 
ence file, which corresponds to s\.file 

/tmp/$$* 

temporary files 


SEE ALSO 

dictadd, diction, double, proofr, punct, spelladd, spelltell, spellwwb, vi, 
worduse, wwb 


NOTES 

1. proofvi needs to know the terminal type and requires a screen of at 
least 24 lines and 80 columns. It will split the screen into three sec- 
tions: a top text section (17 x 80), a menu section (6 x 80), and a bot- 
tom line status section (1 x 80). If your screen has fewer than 24 lines 
or fewer than 80 columns, you will receive an error message when 
you try to invoke proofvi. If your screen has more than 24 lines, only 
24 lines will be used; the rest will be blank. 

2. If you have a file called $HOME/lib/wwb/ddict, proofvi will locate or 
ignore phrases in ddict, as specified, when it runs diction. See dic- 
tion and dictadd for more information. 


If you have a file called $HOME/lib/wwb/spelldict, proofvi does not 
list words in spelldict as errors. See spellwwb, spelladd, and dictadd 
for more information. 

3. You will be able to use the following subset of vi commands to edit 
the file displayed in the upper section of your screen. All commands 
listed behave the same way as they do in the vi editor, except as 
noted. In the commands below, [n] indicates that the command can 
optionally be preceded by a number, n, to perform the command on n 
objects, and char stands for any single character. 

• Delete commands: [n]dw, d[n]w, d$, D, dd, [n]x, dfchar, dt char, 
dF char, dlchar, d[n]SPACE BAR, [nJdSPACE BAR, d[any other search 
command], (Delete commands do not operate across line boun- 
daries.) 

• Change commands: [n]cw, c[n]w, c$, C, cc, cichar, ct char, cF char, 
cT char, [n]r, [n]s, S, c[n]SPACE BAR, [n]cSPACE BAR, c[any other 
search command]. (Change commands do not operate across line 
boundaries.) 

■ Change case command: [n]~ 

■ Insert/append commands: i, a, I, A 
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■ Cursor movement commands: +, RETURN, SPACE BAR, j, k, h, 1, 
H, L, M 

• Search commands on a line: b, B, e, f, F, t, T, w, W, ; 

■ Scrolling and paging: Ctrl-F, Ctrl-B, Ctrl-D, and Ctrl-U. (Ctrl-F 
moves the cursor 16 lines forward, Ctrl-B moves 16 lines back on the 
screen if possible, Ctrl-D moves the cursor 8 lines down, and Ctrl-U 
moves the cursor 8 lines up.) 

■ Shell escape: :!sh 

■ List line (showing non-printing characters): :1 

■ Status queries: :f, Ctrl-G (will also tell you how many errors 
remain.) 

■ Redraw the screen: Ctrl-L 

■ Open a new line: O, o 

■ The last deleted text is saved and it can be put back with: p, P 

■ Redo the last change action: . 

■ Undo the last action or reset the line to its original form: u, U 

■ Write the changes made so far to sv.file, and write the remainder of 
the reference file to svref. file with :w. 

■ Exit commands: :wq, ZZ, :q! 

The following vi commands are not implemented by the interactive 
proofreader: 

• String searches 

■ ex commands except :w, :wq, :q!, :!, :1 :f 

■ Marking of lines with the m command. 

■ Going to lines by number. 

■ Named buffers 

• Saved text except for the last deleted text. 

■ There is little crash recovery without previous writing out with :w. 

■ Set commands 

• EXINIT values 

■ 0 and () matching 

■ Return with " 

■ Yanking with Y or y 

« Joining text lines with J 

■ Global commands 

If you type any unimplemented vi command in proofvi, the program 
will ring the terminal bell and print a message in the bottom status 
window that the command is not implemented. 


3-92 WRITER’S WORKBENCH USER’S GUIDE 



proofvi 


proofvi 


EXAMPLES 

Type 


proofvi exfile 

to run stages one and two of the proofvi program. The first time you type it, 
proofvi will start up (in the background) to locate errors and create a refer- 
ence file called ref.exfile. Wait until proofvi sends you mail announcing that 
stage one is complete, and then type the command again to invoke the 
interactive corrector program. 

If you change the name of the reference file, the new name must be given 
after the — f option when you run the second stage to make corrections. For 
example, if your file is named docl, ref.docl will be created when you run 
proofvi. If you change the name of ref.docl to correct.docl, you would type 
the following command line to make corrections: 

proofvi — f correct.docl docl 

The command 

proofvi — e docl 

will run both stages in the foreground and will start stage two, the interactive 
corrector program, as soon as stage one is complete. 
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NAME 

prose — describe style characteristics of text 
SYNOPSIS 

prose [— IsOV] [— i g|n] [— m m|n|s] [— u t\e\o standards- file] [— f style-file] 

[reroff-options] [ — ] [—\file ...] 

DESCRIPTION 

prose describes the writing style of a document as determined by style, but 
the output is in prose form. The output describes readability, word and sen- 
tence length, sentence structure, sentence type variation, and the 
verb /adjective ratio, prose creates a file called styl.tmp, which contains the 
table produced by style. 

The program checks that a document's scores on certain style variables fall 
within a range for documents of a specified type. Use the — u arg option to 
choose the type of standards, prosestnd prints the exact range that prose con- 
siders acceptable for any set of standards. Whenever the score for a variable is 
outside this range, prose prints a warning message with information about the 
variable and the commands that can be run to get further information. 

When you give prose multiple input files, it combines them to produce one 
description. Multiple files cannot be given as arguments to the — f option, 
prose is one of the programs run by the wwb command. 

Options are: 

—1 Produce a long version, including explanations of variables and 
options. This is the default. (You can change this default by set- 
ting the environmental variable WWBLEV. See the note on the 
manual page for wwb.) 

— s Produce a short (10 line) summary version of the prose output. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— f style-file 

If a file containing the style table exists as output from the style 
program or from a previous prose run, it may be specified so that 
prose need not run style again, styl.tmp can be used as the 
style-file. The input text file should not be used with the — f 
option. 

— i g Ignore list items, as defined by mm macros, in the analysis. This 

is the default. 

— i n Include list items in the analysis. This option should be used if 
the text contains lists of sentences but not if the text contains 
lists of non-sentences. 

— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 
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— m n The input text does not contain macros; it is already formatted. 
The program uses reroff to identify text that is not part of sen- 
tences and eliminates that text from the analysis. 

— m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 

— u t Use standards for technical documents for comparison. This is 
the default. 

— u e Use standards for educational documents for comparison. 

— u o, standards- file 

Use standards contained in the user-specified standards-file for 
comparison. See mkstand to set up the standards-file. 

reroff-options 

Use only with — m n option. 

— h All line-end hyphenated words will retain their hyphens in 

the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if num= 1, double-spaced if num=2, 
triple-spaced if num= 3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

— Delimit the end of options. 

— Use standard input. 

NOTES 

1. If you use formatting header files (which can contain formatting com- 
mands and definitions of macros), include them as part of the input 
text. This is necessary because prose runs deroff on files that contain 
formatting macros to strip non-sentence text from the input, and 
deroff needs to know about formatting commands you have defined 
yourself in order to interpret them later. If your text does not contain 
formatting commands, prose can use reroff to identify text that should 
be ignored in the analysis (use the — m n option). 

2. Some of the prose recommendations do not apply to procedural text. 
(Use murky to analyze the style of procedural text.) 

3. style defines compound sentences as those with compound verbs, or 
those with two clauses joined by a coordinate conjunction, which is 
slightly different from the standard English definition of compound 
sentences. 


3-96 WRITER’S WORKBENCH USER’S GUIDE 



prose 


prose 


FILES 

styl.tmp contains style table 

/usr/lib/wwb/prosedoc This directory contains standards used for com- 
parison and stored prose output text files. 

SEE ALSO 

deroff, match, mkstand, parts, prosestnd, reroff, style, worduse, wwb 

BUGS 

English grammar is complex, so parts and prose make some mistakes, parts is 
about 95% accurate. 

Use of non-standard formatting macros may cause style to break sentences 
incorrectly. 

parts assumes the input text uses correct grammar. If it does not, parts, style, 
and, therefore, prose make mistakes. 

style and parts will not recognize imperative sentences unless they end with 
instead of a period alone. (See the manual page for parts). 

EXAMPLE 1 

$ prose exfile 

May 6 09:21 1985 prose -m m — i g — 1 -u t exfile Page 1 

BECAUSE YOUR TEXT IS SHORT (< 2000 WORDS & < 100 SENTENCES), 

THE EOLLOWIN3 ANALYSIS MAY BE MISLEADING. 

NOTE: Your document is being compared against standards 
derived fran 30 technical documents, classified as good 
by technical nenagers. 

READABILITY 

The Kincaid readability formula predicts that your text 
can be read by someone with 12 or more years of schooling, 
which is a good score for documents like this. 

VARIATION 

Variation in sentence length, type, and openings 
prevents ncnotany. More importantly, a lack of such 
variation suggests that every topic and every sentence has 
equal weight, which makes it difficult for the reader to 
pick out the important points. 

In this text 57% of the sentences are simple and 7% 
are complex. These percentages should be closer together. 

The difference between these percentages, here 50, should be 
less than 30. In addition, 29% of the sentences are 
ccrrpound and 7% are compound-complex, for a total of 36%. 

Most good documents of this type have a combined compound 
percentage between 6% and 35%. 

Although the short, simple sentence is the most direct 
and comprehensible form for an individual sentence. 
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overusing such sentences nay make a document seem 
disjointed. Writing instructors say that a document is 
better when less important ideas are grammatically 
subordinated to more important ones so that the grammatical 
structure emphasizes the logical structure. 

However, this text also contains many compound and 
compound-complex sentences. Instead of combining simple 
sentences, you might introduce variation by dividing seme of 
the catpound-ccmplex sentences into complex sentences. 

If any of the advice given above is contradictory, it 
is best to work an one problem. Look at how the scores an 
this text compare with the standards . Then work an the 
variables that are furthest from the standards. Remember 
that all these sentence variables are related. For example, 
when you change a compound sentence to two short, simple 
sentences, you also: 

- decrease the percentage of compound sentences, 

- increase the ratio of simple sentences to complex 
sentences , 

- decrease the average sentence length, 

- decrease the reading grade level of the text. 


May 6 09:21 1985 prose -m m — i g — 1 -u t exfile Page 2 
SENTENCE STRUCTURE 
Passives 

This text contains a higher percentage of passive 
verbs (29.0%) than is ocrnmon in good documents of this 
type. The score for passive verbs should be below 28.6%. 
A sentence is in the passive voice when its grammatical 
subject is the receiver of the action. 

PASSIVE: The ball was hit by the toy. 

When the doer of the action in a sentence is the subject, 
the sentence is in the active voice. 

ACTIVE: The boy hit the ball. 

The passive voice is sometimes needed 

1 . to emphasize the object of the sentence , 

2. to vary the rhythm of the text, or 

3. to avoid naming an unimportant actor. 
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EXAMPLE: The appropriations were approved. 

Although passive sentences are sometimes needed, 
psychological research has shown that they are harder to 
comprehend than active sentences . Because of this you 
should transform as many of your passives to actives as 
possible. You can use the style program to find all your 
sentences with passive verbs in them, by typing the 
following command when this program is finished. 

style -p p file 
Verb-Ad jective_Ratio 

You have a high verb-adjective ratio, which means that 
you have limited your modifiers appropriately. 

Ncminalizatians 

You have appropriately limited your ncminalizatians 
(nouns made frcm verbs, e.g. , "description"). 

PROSE OUTPUTS 

Options 

You can request that prose use different standards 
when evaluating your document. For exanple typing "-u e" 
with the prose command, e.g., 


May 6 09:21 1985 prose -m m — i g — 1 — u t exfile Page 3 


prose -u e file 

will compare your text against educational documents. 

A -s option will provide a very short version of the 
prose output. 


prose -s file 

If you already have a style table in a file, you can 
save time by using it as the input to prose rather than the 
textfile. To do this, precede the style table filename with 
a -f, e.g. , 


prose — f style-file 

All the options can be selected at the same time and 
listed in any order. 
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prose -f style-file -s -u e 


Statistics 

The table of statistics generated by the program style 
can be found in your file styl.tmp. If you want to look at 
it type: 


cat styl.tnp 

You can also use the match program, which provides a better 
format, type: 


match styl.tnp 

If you are not interested in the file, remove it by typing: 
rm styl.tnp 


ORGANIZATION 

The prose program cannot check the content or 
organization of your text. One way to look at the overall 
structure of your text is to use grep to list all the 
headings that were specified far the mn formatter. To do 
this, type: 


grep ,/ '.H' file 

You can also use the organization program, org, to lock 
at the structure of your text. It will format your paper 
with all the headings and paragraph divisions intact, but 
will only print the first and last sentence of each 
paragraph in your text so you can check your flow of ideas. 

org file 

EXAMPLE 1 EXPLANATION 

1. The command line shows you want prose to describe the style charac- 
teristics of your text, exfile. 

2. prose displays the options it is using. Here the default options 
(— m m, — i g, —1, and — u t) are being used. — m m runs deroff to el- 
iminate mm macros and text that is not part of sentences, — i g elim- 
inates list items from the analysis, —1 produces the long output, and 
— u t compares your text to standards for technical documents. 

3. The output tells you that analysis of short text may be misleading be- 
cause the scores that prose looks at are percentages. When a text is 
very short, the percentages may be unrealistically high. For example, 
if 5 words of 100 (5%) are nominalizations, prose will say you have 
used too many nominalizations when five are probably acceptable. 
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4. The output next states that your text is being compared against stan- 
dards for technical documents. 

The READABILITY section tells you your text can be read by someone 
with 12 or more years of schooling, which is good for a document be- 
ing compared against technical standards. 

Variation in sentence length, type, and openings is described in the 
VARIATION section. If exfile had nearly equal percentages of simple 
and complex sentences, and had a lower percentage of compound sen- 
tences, this section would not be printed. 

prose prints a detailed explanation of passives because exfile had a 
high percentage of them. 

Because exfile did not contain too many nominalizations, the long ex- 
planation is skipped. 

prose also describes some of its other options, such as comparing do- 
cuments to educational standards. 

10. prose tells you it put the style table in a file called styl.tmp and tells 
you how to look at it or remove it. 

11. A brief discussion of text organization is given at the end of the 
analysis. 

EXAMPLE 2 

The command: 

prose — u e — i n edfile 

will describe how the style characteristics of edfile compare with standards 
for educational documents. Lists will be included in the analysis. The style 
table will be left in the file styl.tmp. Then the command: 

prose — u o,mystands — f styl.tmp 

will use the existing style statistics gathered in styl.tmp for edfile and 
describe how they compare with the user-defined standards contained in my- 
stands, which was created with mkstand. 


5. 

6 . 

7. 

8 . 
9. 
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NAME 

prosestnd — print standards used by prose 
SYNOPSIS 

prosestnd [— OV] [— u t\e\o, standards-file] 

DESCRIPTION 

prosestnd reads the standards files that are used by prose and prints the 
acceptable ranges of 11 style scores for documents of certain kinds, prose 
considers scores that fall within these ranges to be good. The arguments to 
the -u option tell prosestnd what standards file to read: technical, educa- 
tional, or a user-specified standard. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— u t Print acceptable ranges of style scores for technical documents. 
This is the default. 

-u e Print acceptable ranges of style scores for educational documents. 
— u o, standards- file 

Print acceptable ranges of style scores contained in the user- 
specified standards- file. The standards-file can be made using 
mkstand. 

FILES 

/usr/lib/wwb/prosedoc/tech.stand contains standards for technical docu- 
ments used by prose 

/usr/lib/wwb/prosedoc/educ.stand 

contains educational standards used by 

prose 

SEE ALSO 

mkstand, prose, style, wwb 
EXAMPLE 

$prosestnd 
prosestnd -u t 

These are desirable ranges far technical documents based 
an 30 technical documents judged good by technical managers: 


Kincaid readability grades: >10.1 to 15.0 years 

Average sentence length: 16.7 to 25.3 words 

Average length of content words: 5.8 to 7.0 letters 

Percentage of short sentences: 29.2% to 38.0% 

Percentage of long sentences: 11.7% to 18.9% 


Percentage of simple sentences minus 

the percentage of ccnplex sentences: -24.2% to 30.1% 
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Percentage of compound sentences plus 

the percentage of canpound-canplex sentences : . . 5 . 7% to 35 . 2% 


Passives should be fewer than: 28.6% 

Verb-adjective ratio should be higher than: .... 0.35 

Naturalizations should be fewer than: 4.2% 

Expletives should be fewer than 5.7% 


EXAMPLE EXPLANATION 

1. The command line shows you want to read the standards prose uses to 
analyze text. 

2. prosestnd displays the default option it is using, — u t. The program 
will print the standards for technical documents. 

3. The acceptable ranges of 11 style scores for technical documents are 
printed. 
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NAME 

punct — check punctuation 
SYNOPSIS 

punct [— OV] [ ] [— \file ...] 

DESCRIPTION 

punct searches for punctuation errors. When it finds an error, it prints the 
original line, followed by a corrected version, with the line number of the 
error, punct creates a changed version of the document and asks if you want 
this version saved in your current directory in a file called pu.file. (No 
changes are made to the original text file. The changes are written to the 
standard output and to pu.file.) The changed version is available when you 
run punct, but not when proofr, wwb, or proofvi run punct. punctrls prints 
a list of punctuation rules. 

punct does the following: 

1. Moves commas and periods inside double quotation marks 
(except when only one character is between the quotation marks) 
and moves semicolons and colons outside double quotation 
marks. 

2. Warns of unbalanced double or single quotation marks or 
parentheses. 

3. Places periods that are before a right parenthesis after it when 
the phrase within the parentheses does not begin with a capital 
letter. 


4. Changes double semicolons, commas, question marks, or periods 
to single marks. 

5. Inserts space between two sentences, if needed. 

6. Capitalizes the first word of a sentence, if necessary. 

7. Puts a space after a comma, semicolon, or exclamation point, if 
needed. 


8. Removes commas, colons, or semicolons that precede a left 
parenthesis and puts them after the right parenthesis. 

punct is one of the programs run by the proofr and wwb commands, proofvi 
also runs punct, but it does not count the apostrophes, quotes, or parentheses. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 


Delimit the end of the options. 

— Use standard input. 

FILES 

pu .file contains changed version of input text 

/tmp/$$* temporary files 

SEE ALSO 

punctrls, proofr, proofvi, wwb 
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BUGS 

punct will consider unfamiliar abbreviations ending with a period (except ini- 
tials) to be the end of the sentence; consequently, it will capitalize the next 
word. 

The discrimination of apostrophes and single quotes assumes that the input is 
standard English prose. The use of an apostrophe for prime will lead to 
incorrect tallies. 

EXAMPLE 

$punct exfile 
punct exfile 

0 double quotes and 0 single quotes 

0 apostrophes 

1 left parentheses and 1 right cues 


line 13 

OLD: of rodent attack to cables, later, Lizell et. al. ran tests 
NEW: of rodent attack to cables. Later, Lizell et al. ran tests 

The changed version of your text is in your file named pu. exfile. 
Do you want to save it? (y or n) 

>y 


For more information about punctuation rules, type: 
punctrls 


EXAMPLE EXPLANATION 

1. The command line shows you want punct to check for punctuation er- 
rors in exfile. 

2. punct displays the command line, showing that there are no default 
options. 

3. The output reports the number of apostrophes, quotation marks, and 
parentheses. The program can only count these marks, and if it finds 
an imbalance, it cannot tell you where a mark is missing or an extra 
one has been added. 

4. The program tells you the line number where a punctuation error is 
located in your text. The incorrect line in your input file is labeled 
OLD:. The word "later" at the beginning of a sentence is not capital- 
ized, and there is a period after the word "et," which is not an abbrevi- 
ation. 

The line labeled NEW: shows you the suggested changes to the in- 
correct line (no change has been made to your original text file). The 
word "later" is capitalized, and the period following "et" is removed. 

5. punct put a copy of exfile in a file called pu.exfile with the word 
"later" capitalized and no period after "et." If the changes punct made 
are correct, you may want to save pu.exfile by typing y (for "yes") or 
you can type n to remove pu.exfile. 
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If you do not understand why punct found errors, punctrls will 
describe some punctuation rules that it follows. 
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NAME 

punctrls — print punctuation rules 

SYNOPSIS 

punctrls [— OV] 

DESCRIPTION 

punctrls prints a list of some standard American English punctuation rules, 
punct finds violations of some of these rules; others, it is unable to detect. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

SEE ALSO 

proofr, proofvi, punct, wwb 

EXAMPLE 

$punctrls 

1 . Periods and comas always go inside double quote marks . 

EXAMPLE: "I want to go to the fair," he said. 

The only allowable exception is a single character 
in quotes, e.g. , use a tilde 

2. Semicolons and colons always go outside double quotes. 

EXAMPLE: He knew what was meant by "hardcopy"; he didn't 
knew about "software." 

3. Question marks and exclamation narks go inside or outside 
double quote marks depending an the sentence sense. 

EXAMPLE: "Where are you going7" he asked. 

What is meant by the word "firmware"? 

4. When a quote ends with a question mark that ends a clause 
and a coma would normally appear at the end of the clause, 
it is standard to leave the coma out. (The first example 
sentence under item 3 illustrates this . ) 

5. When using single quote narks instead of double quote marks, 
the same rules apply. (Single quotes are considered 
incorrect, except inside a quotation enclosed in double 
quotes . ) 

6. When a sentence is enclosed in parentheses, the period goes 
inside the closing parenthesis. 

EXAMPLE: (This is a sentence. ) 
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7. If the words inside parentheses do not constitute a sen- 
tence, but are at the end of the sentence, the period goes 
after the closing parenthesis. 

EXAMPLE: This is a sentence (but not this). 

8. No commas, semicolons, or colons should appear before a left 
parenthesis. If such punctuation is needed, it is placed 
after the phrase in parentheses. 

EXAMPLE: After eating salt (sodium chloride), he threw up. 

9. Dashes never occur next to ccmmas, semicolons, blank spaces, 
or parentheses. 

EXAMPLE: Before World War I — but not afterwards — Iceland was 
a part of Denmark. 


EXAMPLE EXPLANATION 

The command line shows you want to see a list of standard punctua- 
tion rules, (punct does not enforce all of them; for example, it cannot 
do #3.) 

Punctuation rules are printed first, and where appropriate, an example 
illustrating a particular rule appears next in the output. Any excep- 
tions to the rule follow. 
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NAME 

reroff — convert formatted text into mm/nroff input file 
SYNOPSIS 

reroff [— hOV] [— B num] [—1 num] [— P num] [ — ] [— \file ...] 

DESCRIPTION 

reroff converts text files formatted by most formatters (for example, mm, 
nroff/troff, and Wang) to the input format used by mm. This program is 
designed as the first operation for the WRITER'S WORKBENCH system stylistic 
programs. Thus, files for which there is no mm/nroff input form can still be 
used by these programs. Additionally, the program can be used to generate 
an input form for texts read by optical scanners or for output forms collected 
from several different sources. 

reroff is a filter. When you give it multiple input files, it produces one stan- 
dard output for all input files. 

You can use options to override between-line spacing, the left-hand margin, 
and paragraph indent and to provide line-end hyphenation. These options 
are most useful for oddly formatted documents, which are being incorrectly 
interpreted by reroff. 

Options are: 

— h All line-end hyphenated words will retain their hyphens in the 

output, although the words will be put back together. If the — h 
option is not given, hyphenated words will be put back together 
without a hyphen. 

— O Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— B The input text has between-line spacing equal to num, that is, 
the input is single-spaced if rmm= 1 , double-spaced if num= 2 , 
triple-spaced if mim=3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

— Delimit the end of options. 

— Use standard input. 

SEE ALSO 

aero, conscap, consist, mm, morestyle, murky, nroff, org, parts, prose, style, 
switchr, topic, troff, wwb 

NOTES 

reroff writes all the lines it throws away, that is, lines it has classified as page 
headers and footers, to a file called reroff.err. It also writes the values it has 
determined for each page: indent, paragraph indent, justification, and spacing. 
You can examine this file to determine whether parts of the text were 
incorrectly discarded or whether the text was radically misunderstood. If 
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there are many errors, you can run the program again, specifying the correct 
values for — B, —I, and — P. 

reroff cannot always determine the appropriate relations if non-standard 
printing conventions are followed; for example, text that is all uppercase or 
all lowercase will not always be handled properly, and non-indented para- 
graphs must be marked by a blank line followed by a capital letter. Thus, an 
all-lowercase file with non-indented paragraphs will not have marked para- 
graphs. Input text that is all bold or underlined will also be misinterpreted. 

EXAMPLE 

Sircn exfile > exfile. out 
$cat exfile. out 

Many biological organisms cause damage to ccmnunicatian 

wires and cables; bacteria, fungi, insects, rodents, and 
marine borers are examples. However, the most rapid and 
extensive damage is caused by various species of rodents. 

As early as 1935 the English reproted rat damage to 
lead sheathed cables, and in 1937 Gertsch reported 71 cases 
of rodent attack to cables. later, Lizell et. al. ran tests 
with caged adult female white rats that were given adequate 
food and water. All rubber and plastic materials were 

attacked; the harder the material and the larger the sairple, 
the more difficult it was for the animals to cause damage. 

Since the early studies of gopher-resistant materials, 
an large number of new wire, cable, and designs have been 
developed and and many new materials are available. The 
Denver Wildlife and Research Centre (DWRC) and the Bell 
Telephone Laboratories decided to join together to test the 
gopher resistance of the new designs . The manpower for the 

experiments came fran both EWRC and BTL; Bell prepared the 

test samples, took photographs after exposure to gophers, 
and analyzed the engineering implications of the results, 
and the dwrc designed and conducted the exposure test and 
rated the damage to the sarrples. 

The animals were housed in individual cages in a 

standard laboratory bioassay rack. The diet consisted of 

laboratory chow, carrots and occasionally dry alfalfa, but 

no water. The gophers were not separated as to size or sex. 

Specimens were randomly tested with individual gophers. 

The natural tendency of gophers to repeatedly chew an 

objects eliminated the need to provide any incentive such as 
food near the specimens. 


reroff 


BUG 
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Sreroff exfile. out 
reroff exfile. out 
.HP 1 
.SA 1 
• nr Pt 1 
.P 

Many biological organisms cause damage to ccnmunicatian 
wires and cables; bacteria, fungi, insects, rodents, and 
marine borers are examples. 

However, the most rapid and 

extensive damage is caused by various species of rodents. 

■ P 

As early as 1935 the English reproted rat damage to 
lead sheathed cables, and in 1937 Gertsch reported 71 cases 
of rodent attack to cables, 
later, Lizell et. al. ran tests 

with caged adult female white rats that were given adequate 
food and water. 

All rubber and plastic materials were 

attacked; the harder the material and the larger the sample, 
the more difficult it was for the animals to cause damage. 

.P 

Since the early studies of gopher-resistant materials, 
an large number of new wire, cable, and designs have been 
developed and and many new materials are available. 

The 

Denver Wildlife and Research Centre (DWRC) and the Bell 
Telephone Laboratories decided to join together to test the 
gopher resistance of the new designs. 

The manpower for the 

experiments came from both EWRC and BTL; Bell prepared the 
test samples, took photographs after exposure to gophers, 
and analyzed the engineering implications of the results, 
and the dwrc designed and conducted the exposure test and 
rated the damage to the samples. 

.P 

The animals were housed in individual cages in a 
standard laboratory bioassay rack. 

The diet consisted of 

laboratory chow, carrots and occasionally dry alfalfa, but 
no water. 

The gophers were not separated as to size or sex. 

Specimens were randomly tested with individual gophers. 

.P 

The natural tendency of gophers to repeatedly chew on 
objects eliminated the need to provide any incentive such as 
food near the specimens. 


EXAMPLE EXPLANATION 

The first command line requests that your file called exfile be format- 
ted using mm and the results put in a file called exfile.out. 
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2. The second command line requests that the formatted file, called 
exfile.out, be printed with the cat command. The formatted file is 
shown. 

3. The next command line requests that reroff convert the formatted file, 
exfile.out, to input used by mm. The output from this command is a 
text file with mm macros. 
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NAME 

sexist — print sexist terms and suggest alternatives 
SYNOPSIS 

sexist [— dlsOV] [— f dictionary-file] [ — ] [— \file ...] 

DESCRIPTION 

sexist locates and prints all sentences in the input text that contain sexist 
words or phrases based on a comparison with a dictionary of sexist phrases. 
The word or phrase in each sentence is surrounded with asterisks and brack- 
ets, for example, *[girl]*, and the line numbers of the sentences are also 
printed. 

sexist also suggests substitutions for the sexist phrases found in the input text. 
The substitutions encourage: 

• Describing men and women in parallel terms. For example, "men and girls” 
should probably be changed to "men and women." 

■ Using neutral terms instead of sex-related terms. For example "business exe- 
cutive" could replace the stereotypic "businessman." 

■ Using non-sexist job titles. 

When you give sexist multiple input files, it prints the phrases found in each 
file in sequence and then prints one Table of Substitutions. 

If you have a file named $HOME/lib/wwb/sexdict, sexist locates or ignores 
phrases contained in that file. dictadd can be used to set up 
$HOME/lib/wwb/sexdict. dictadd gives instructions for adding phrases to be 
located or ignored by sexist. 

Options are: 

— d Print the pathnames of the default sexist phrase and substitution 

dictionaries, then exit. 

—1 Produce a long version by printing sexist sentences and a Table 
of Substitutions. This is the default. (You can change this 
default by setting the environmental variable WWBLEV. See the 
note on the manual page for wwb.) 

— s Produce a short version by excluding the Table of Substitutions. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— f dictionary-file 

Use the phrase file, dictionary-file in addition to the standard 
dictionary of sexist phrases. When the — f dictionary-file option 
is used, sexist does not check $HOME/lib/wwb/sexdict for 
phrases, dictadd can be used to create dictionary-file. 

— Delimit the end of options. 

— Use standard input. 
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FILES 

/usr/lib/wwb/sexwords.d 
/ usr / lib / w wb / sexsugg.d 
/tmp/$$* 

SEE ALSO 

dictadd 

BUGS 

Because sexist does not consider context, it may bracket phrases that are used 
appropriately, and it may recommend inappropriate alternatives. It is up to 
you to determine which changes should be made. 

If formatting macros are included in the input text, the beginning line 
number of a sentence containing a sexist phrase may be a line containing a 
macro preceding the sentence. 

sexist makes no attempt to segment text into sentences accurately, for exam- 
ple, it does not know any abbreviations. 

sexist may not find the second of two consecutive sexist phrases, and it may 
not find a sexist phrase at the end of a sentence. 

EXAMPLE 1 

Jsexist exfile 
sexist —1 exfile 

beginning line 25 exfile 

The *[ manpower ]* for the experiments came frcm both DWRC and 
BTL; Bell prepared the test samples, took photographs after exposure 
to gophers, and analyzed the engineering duplications of the results, 
and the dwrc designed and conducted the exposure test and rated 
the damage to the samples. 

file exfile: number of lines 42 number of phrases found 1 
Please wait for the substitution phrases 


sexist phrase dictionary 

dictionary of sexist phrase alternatives 

temporary files 


Table of Substitutions 

PHRASE SUBSTITUTION 

manpower: use "personnel, staff, workers" for " manpower" 

EXAMPLE 1 EXPLANATION 

1. The command line shows you want sexist to locate any potentially 
sexist words or phrases in your file named exfile. 

2. sexist displays the options it is using. Here, it is using the default op- 
tion, —1, to produce the long version of output, which includes expla- 
nations. 

3. The program tells you the beginning line number of sexist words or 
phrases. 
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4. The asterisks and brackets highlight any of the possibly sexist words 
and phrases found in exfile, for example, *[ manpower ]*. 

5. The Table of Substitutions gives you alternatives to sexist terminology. 
For "manpower," it suggests you use "personnel," "staff," or "workers." 

EXAMPLE 2 

The command 

sexist — f patfile exfile 

will print sentences from exfile that contain sexist words or phrases and will 
include or suppress phrases as specified in patfile. Suggested replacements 
for sexist phrases will also be printed, sexist will not locate or ignore phrases 
in $HOME/lib/wwb/sexdict when the — f option is used. 
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NAME 

spelladd — add words to user's spelling dictionary 
SYNOPSIS 

spelladd [— OV] [ — ] word ... 

DESCRIPTION 

spelladd adds words, specified by you, to $HOME/lib/wwb/spelldict and 
maintains this dictionary in sorted order. Once correctly spelled names, acro- 
nyms, special terms, and other words not in the standard dictionary for 
spellwwb are added to $HOME/lib/wwb/spelldict, the spellwwb program 
will no longer list them as possible spelling errors, proofr, proofvi, 
spellwwb, and wwb check $HOME/lib/wwb/spelldict automatically. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— Delimit the end of the options. 

NOTE 

Words with apostophes must be enclosed in double quotes ("Mary's"), or you 
must escape the apostrophe with a backslash (Mary\'s). Otherwise, the shell 
will interpret the apostrophe as the start of a quoted expression that has not 
been completed, and it will display a secondary shell prompt, which means it 
is waiting for you to finish a command. 

FILES 

$HOME/lib/wwb/spelldict produced by spelladd 
/tmp/$$spadd temporary file used by spelladd 

SEE ALSO 

dictadd, proofr, proofvi, sort, spell, spelltell, spellwwb, uniq, wwb 
EXAMPLE 1 

To add words to $HOME/lib/wwb/spelldict, type: 

Sspelladd wordl word2 word3 ... 


EXAMPLE 2 

Use the following method when there are many words from one file to be 
added to spelldict. 

First, correct all real spelling errors found in a file by spellwwb. Then, type 
the following command lines to have all the remaining (correct) words listed 
by spell added to $HOME/lib/wwb/spelldict: 

$spell corrected-file >> $HOME/lib/wwb/spelldict 
Sspelladd 

Using spelladd by itself on the command line automatically does a uniq and 
sort on your spelldict dictionary, that is, it eliminates duplicate words and 
alphabetizes the entries. In the example above, spell may have found words 
that are already in your spelldict dictionary. (Remember, spellwwb automati- 
cally searches spelldict, but spell does not.) 
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You can also use the dictadd command to add words to 
$HOME/lib/wwb/spelldict. dictadd gives detailed instructions and prompts 
you by asking questions; spelladd is a faster way to add words to 
$HOME/lib/ wwb/spelldict. 
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NAME 

spelltell — find the correct spelling of a word 
SYNOPSIS 

spelltell [— dOV] [ — ] [misspelled word] 

DESCRIPTION 

spelltell helps you find the correct spelling of a word. When spelltell is 
typed on a line with the misspelled word, it will return one possible correct 
spelling at a time. Type a carriage return to see the next suggested spelling. 
When you type spelltell on a line by itself and your WWBLEV variable is not 
set or is set to 1 (lowercase letter ”1") in your .profile, the program first asks if 
you want instructions and then prompts you for a word. (See the note on the 
manual page for wwb to change the WWBLEV variable.) To quit, type q after 
the prompt. 

The spelltell function can be run from proofvi. 

Options are: 

— d Print the pathname of the spelltell dictionary directory, then 

exit. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— Delimit the end of the options. 

NOTES 

1. spelltell assumes that the first letter of the misspelled word is correct. 
(This is not true only 2.69% of the time.) There are 26 spelltell dic- 
tionaries, one for each letter of alphabet, which contain a total of 
27,300 words. These dictionaries are each sorted by length of word, 
with the shortest words first. 

To determine the best match for a given input, spelltell reads each 
entry in the appropriate dictionary and applies a pattern-matching 
algorithm to find the length of the longest matching common sub- 
sequence between the input word and the dictionary entry. When 
there are multiple words that are equivalently close to the input, the 
shortest will be returned first. 

2. spelltell was previously released as grope. 

FILES 

/usr/lib/wwb/spelltell/dic_a, dic_b ... dic_z dictionaries of correct spellings 
SEE ALSO 

proofr, proofvi, spellwwb, wwb 

EXAMPLE 

Sspelltell 

Do you want instructions? (y or n) 

y 

The spelltell program searches its dictionary for a word that is 
closest in spelling to a word given to it. First, it will give you a 
word praipt. At the prarpt, you should type vhat you think is the 
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correct spelling for your word followed by a carriage return. The 
program will then print its word with the closest spelling. As you 
enter more carriage returns it will print other possible corrections . 
If you type a new word after spelltell 's response, spelltell will 
print what it thinks is the correct spelling for the new word. 

After your last word, type q (far quit). You can also run 
this program by typing: 

spelltell 'word' 


word? correcter 
corrected RETURN 
corrector 
speling RETORN 
spelling 

q 

$ 

EXAMPLE EXPLANATION 

1. The command line shows you want spelltell to find the correct spel- 
ling of words. 

2. spelltell asks if you want instructions and prints them in response to 
y for yes. 

3. The program provides possible correct spellings for the two 
misspelled words you type. 

4. Type q to quit. 
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NAME 

spellwwb — find spelling errors and suggest corrections 
SYNOPSIS 

spellwwb [-blsvxOV] [-f dictionary-file] [ — ] [—\file ...] 

DESCRIPTION 

spellwwb is a modified version of spell, spellwwb compares each word in 
the input file(s) to words in a spelling list. The words it can neither find nor 
derive using certain rules, it lists as possible errors. The long version (the 
default or the —1 option) also uses spelltell to suggest a correct spelling for all 
words listed as errors, except those that begin with a capital letter. 

When you give spellwwb multiple input files, it prints one list of misspel- 
lings for all the files, spellwwb is one of the programs run under the proofr, 
proofvi, and wwb commands, but it does not suggest corrections with these 
programs. 

spellwwb allows you to create your own files of additional legitimate spel- 
lings, by default $HOME/lib/wwb/spelldict. Before reporting words not 
found in spell's dictionary, spellwwb compares them with words in the 
specified file ($HOME/lib/wwb/spelldict by default). 

When text is run through spellwwb for the first time, proper names, acro- 
nyms, and unusual words will be listed as errors. You can add words that are 
spelled correctly to $HOME/lib/wwb/spelldict, and future spellwwb lists 
will omit them. Use spelladd or dictadd to add words to 
$HOME/lib/wwb/spelldict. 

Options are: 

— b Check British spelling. This option can be used with either the 

—1 or — s option. 

—1 Produce a long version, which includes the misspelled words 
together with spelltell's first suggested correction for non- 
capitalized words. This is the default. (You can change this 
default by setting the environmental variable WWBLEV. See the 
note on the manual page for wwb.) 

— s Produce the short version, which is a list of misspelled words 
(without suggested corrections). 

— v Print all words not literally in the spelling list, and show plausi- 
ble derivations from the words in the spelling list. This option 
can be used with either the —1 or — s option. 

—x For each word, print every plausible stem with =. This option 
can be used with either the —1 or — s option. 

— O Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 


MANUAL PAGES 3-123 



spellwwb 


spellwwb 


— f dictionary-tile 

Use the user-specified dictionary, dictionary-file, in addition to 
the standard dictionary of misspelled words. When the — f 
dictionary-file option is used, spellwwb does not check 
$HOME/lib/wwb/spelldict for words, dictadd can be used to set 
up dictionary-file. 

— Delimit the end of options. 

— Use standard input. 

FILES 

$HOME/lib/wwb/spelldict 

user-specified dictionary used by spellwwb 

/tmp /$$* temporary files used by spellwwb and spelladd 

SEE ALSO 

dictadd, proofr, proofvi, spell, spelladd, spelltell, wwb 

EXAMPLE 1 

Sspellwvfo exfile 

spellwwb —1 $HOME/lib/wwb/spelldict exfile 
plausible steins (with =), and/or possibly 
misspelled capitalized words in exfile 
Centre Gertsch Lizell 

EWRC 

Possible misspellings of nan-capitalized words in exfile 

with suggested corrections 

al: ail 

dwrc: Dirac 

reproted: reported 

If any of these words are spelled correctly, later type 
spelladd wordl word2 . . . wordn 
to have them added to your spelldict file. 

EXAMPLE 1 EXPLANATION 

1. The command line shows you want spellwwb to find potential spel- 
ling errors in exfile. 

2. spellwwb displays the options it is using. Here, it is using the default 
option, —1, to produce the long version of output, which includes 
spelltell's first suggested correction for non-capitalized words. 

3. The output shows the potential errors, that is, words that spellwwb 
could not find or derive from the standard UNIX system spelling dic- 
tionary or find in $HOME/lib/wwb/spelldict. A suggested correction 
is given for those words that do not start with a capital letter. 

4. The program next tells you how to add words to your spelldict file. 
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EXAMPLE 2 

$spellwwb -v exfile 

spellwv* —1 -v $H3ME/lih/wwb/spelldict exfile 

Words not literally in the spelling list with plausible derivations, 
and possibly misspelled capitalized words in exfile 


+able 

available 

+re+ed+ly 

repeatedly 

+al+ly 

occasionally 

+s 

Specimens 

+b+er 

rubber 

+s 

animals 

+bio 

bioassay 

+s 

cables 

+bio+al 

biological 

+s 

cages 

+d 

analyzed 

+s 

carrots 

+d 

caged 

+s 

cases 

+d 

caused 

+s 

designs 

+d 

decided 

+s 

examples 

+d 

eliminated 

+s 

experiments 

+d 

housed 

+s 

gophers 

+d 

prepared 

+s 

insects 

+d 

rated 

+s 

materials 

+d 

separated 

+s 

objects 

+d 

sheathed 

+s 

rats 

+ed 

attacked 

+s 

results 

+ed 

conducted 

+s 

rodents 

+ed 

consisted 

+s 

samples 

+ed 

designed 

+s 

specimens 

+ed 

developed 

+s 

tests 

+ed 

tested 

+s 

wires 

+er 

after 

+tele 

Telephone 

+er 

harder 

-e+ian 

catmuni cation 

+er 

number 

-e+ian+s 

implications 

+ing 

engineering 

-ian+ive 

extensive 

+ist+s 

organisms 

-t+ce 

resistance 

+iy 

early 

-y+ies 

Laboratories 

+iy 

randomly 

-y+ies 

studies 

+photCH-S 

photographs 

Centre 


+r 

larger 

DWRC 


+r+s 

borers 

Gertsch 


+re 

Research 

Lizell 


+re+ed 

reported 




Possible misspellings of nan-capitalized words in exfile 

with suggested corrections 

al: ail 

dwrc: Dirac 

reproted: reported 

If any of these words are spelled correctly, later type 
spelladd wordl word2 . . . wordn 
to have them added to your spelldict file. 

EXAMPLE 2 EXPLANATION 

1. The command line shows you want the — v option to print all words 
in your text that do not appear literally in the spelling dictionary. 
The program will show symbolically how it derived the words. 
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2. spellwwb displays the options it is using. Here, it is using the default 
option, —1, to produce the long version, which includes an explana- 
tion of the output . 

3. The words from exfile are shown with the prefixes and suffixes ap- 
pended to the literal words in the spelling dictionary. These words 
are not literally in the dictionary, but were derived from their roots 
by using affixes. For example, "available" was not in the spelling dic- 
tionary, but by appending "able” to "avail," which is in the dictionary, 
spellwwb derived "available" and does not list it as an error. 

4. The last words on the list are capitalized words not found in the spel- 
ling dictionary. 

5. Finally, spellwwb suggests a correct spelling for possibly misspelled 
words. 
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NAME 

splitrls — print information about split infinitives 

SYNOPSIS 

splitrls [— OV] 

DESCRIPTION 

splitrls prints information about split infinitives. The gram, proofr, and wwb 
programs look for split infinitives in text. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

SEE ALSO 

gram, parts, proofr, wwb 

EXAMPLE 

Ssplitrls 

An infinitive is a verb form that contains the word "to." 

Examples include: 

1. to make 

2 . to pursue 

3. to eat 

4. to be going 

An infinitive is said to be split when a word or phrase 
occurs between "to" and the verb. Possible split infinitives 
include : 

1. to often make 

2. to quickly pursue 

3. to immediately eat 

4. to soon be going 

There is nothing ungrammatical about split infinitives; usu- 
ally, however, they are awkward. If the meaning of the phrase is 
clear without the split infinitive, by all means don't use it. 

There are cases, hcwever, where the meaning is not clear 
unless the infinitive is split. For exaitple a and b do not mean 
the same as c. 

a. Really to understand calculus, you must do the exercises. 

b. To understand calculus really, you must do the exercises. 
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c. To really understand calculus, you must do the exercises. 

In such cases, many grammarians will tell you it is accept- 
able to use the split infinitive. It is usually possible, how- 
ever, to change the form of the sentence as in examples d and e, 
and keep seme readers from downgrading you. 

d. Really understanding calculus requires your doing the exer- 
cises . 

e. To understand calculus fully, you must do the exercises. 

EXAMPLE EXPLANATION 

1. The command line shows you want to see grammatical rules related to 
split infinitives. 

2. The output explains to you what an infinitive is and tells you what a 
split infinitive is. 

3. The output gives an example of when a split infinitive makes the 
meaning clearer. 
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NAME 

style — analyze style characteristics of a document 
SYNOPSIS 

style [— aOV] [— i g|n] [-m m|n|s] [-p e,n,p,en,ep,np,enp] [-L num ] 

[— R num] [— S num] [reroff-options] [ — ] [— |/i7e ...] 

DESCRIPTION 

style analyzes the characteristics of the writing style of a document. It reports 
on readability, sentence length and structure, word length and usage, verb 
type, and sentence openers. The program prints a summary table of these 
statistics. 

You can also give options (— p arg ) to print sentences with particular charac- 
teristics. The arguments to -p can be combined on the command line, 
separated by commas or separated by a space and quoted, to produce various 
subsets of sentences. For example, the command 

style — p p,n file 


or 

style — p "p n" file 

will print sentences that have a passive verb and sentences that contain a 
nominalization. The command 

style — p np file 

will print sentences that have both a nominalization and a passive verb. All 
sentences printed by style have asterisks (*) on each side of the nominaliza- 
tions. 

When you give style multiple input files, it will treat all the files as a single 
unit and produce one style table, style is one of the programs run by the 
wwb and prose programs. 

Options are: 

—a Print all sentences with their length, readability score, and other 
features in addition to the summary table. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— i g Ignore list items, as defined by mm macros, in the analysis. This 
is the default. 

— i n Include list items in the analysis. This option should be used if 
the text contains lists of sentences but not if the text contains 
lists of non-sentences. 

— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 
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— m n The input text does not contain macros; it is already formatted. 
The program uses reroff to identify text that is not part of sen- 
tences and eliminates that text from the analysis. 

— m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 

— p e Print sentences that begin with an expletive. 

— p n Print sentences that contain a nominalization used as a noun. 

— p p Print sentences with passive verbs. 

— p en Print sentences that both begin with an expletive and contain a 
nominalization. 

— p ep Print sentences that both begin with an expletive and contain a 
passive verb. 

— p np Print sentences that have both a nominalization and a passive 
verb. 

— p enp 

Print sentences that have all three types of problems: begin with 
an expletive and contain a nominalization and a passive verb. 

— L num 

Print all sentences longer than num words. 

— R num 

Print all sentences for which the Automated Readability Index 
score is greater than or equal to num. 

— S num 

Print all sentences shorter than num words. 

reroff-options 

Use only with — m n option. 

— h All line-end hyphenated words will retain their hyphens in 

the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if nnm=l, double-spaced if num=2, 
triple-spaced if num= 3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

— Delimit the end of options. 

— Use standard input. 
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NOTES 

1. If you use formatting header files (which can contain formatting com- 
mands and definitions of macros), include them as part of the input 
text. This is necessary because style runs deroff on files that contain 
formatting macros to strip non-sentence text from the input, and 
deroff needs to know about formatting commands you have defined 
yourself in order to interpret them later. If your text does not contain 
formatting commands, style can use reroff to identify text that should 
be ignored in the analysis (use the — m n option). 

2. This note describes in detail the algorithm used by the style program, 
style runs deroff to remove formatting commands and associated text 
that is not part of sentences from the input text. Then it runs parts to 
identify words and sentences and to assign the part of speech to each 
word in the text, style uses this information to compute statistics 
about many stylistic features. Many of these statistics result from 
counting. The more complex measures are described below. The 
definitions style uses to count certain items in the style table are also 
described below. 

Readability Grades 

style reports four readability scores: Kincaid Formula, Automated 
Readability Index (ARI), Coleman-Liau Formula, and Flesch Reading 
Grade Level. They differ because each was experimentally derived 
using different texts and subject groups. 

The Kincaid Formula, given by: 

ReadingGrade = 11.8 X syl_per_wd + .39 X wds_per_sent — 15.59 

was based on Navy training manuals ranging in difficulty from 5.5 to 
16.3 in reading grade level. The score reported by this formula tends 
to be in the midrange of the four scores. Because it is based on adult 
training manuals rather than schoolbooks, this formula is probably the 
best one to apply to technical documents. 

The Automated Readability Index (ARI), based on text from grades 0 to 
7, was derived to be easy to automate. The formula is: 

Reading_Grade = 4.71 X let_per_wd + .5 X wds_per_sent — 21.43 

ARI tends to produce higher scores than Kincaid and Coleman-Liau 
but usually slightly lower than Flesch. 

The Coleman-Liau Formula, based on text ranging in difficulty from 
grades .4 to 16.3, is: 

Reading Grade = 5.89 X letjper wd - .3 X sent_per_100_wd - 15.8 

Of the four formulas, this one usually gives the lowest grade when 
applied to technical documents. 

The Flesch Reading Grade Level is derived from the Flesch Reading 
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Ease Score, which is based on grade school text covering grades 3 to 
12. The formula for the Reading Ease Score is: 

Reading Score = 206.835 — 84.6 X syl_per_wd — 1.015 X wdsjper sent 

It is usually reported in the range 0 (very difficult) to 100 (very easy), 
style prints the Reading Ease Score last, in parentheses. The Flesch 
Reading Grade Level is printed fourth, after "(Flesch)." 

The Flesch Reading Grade Level is scaled to be comparable to the 
other grade level scores by the following formulas: 


IF the Flesch 
Reading Ease Score 
(read ease) is 

THEN the Flesch Reading 

Grade Level (grade_level) 
is 

read_ease >100 

70 < read_ease <100 
60 < read_ease < 70 

50 < read ease < 60 

30 < read_ease < 50 
read ease < 30 

grade_level = 4 

gradelevel = (100 — read_ease)/10 + 5 
grade level = (70 — read_ease)/10 + 8 
grade level = (60 — read_ease)/5 + 10 
grade level = (50 — read_ease)/6.66 + 13 
grade level = 17 


Thus, the Flesch Reading Grade Level cannot be higher than 17 or 
lower than 4. It is usually the highest of the four scores on technical 
documents. 

E. Coke, a researcher at AT&T Bell Laboratories, found that the Kin- 
caid Formula is the best predictor for technical documents; both ARI 
and Flesch tend to overestimate the difficulty; Coleman-Liau tends to 
underestimate. On text in the range of grades 7 to 9, the four formu- 
las tend to be about the same. On easy text, the Coleman-Liau for- 
mula is probably preferred because it is reasonably accurate at the 
lower grades and it is safer to present text that is a little too easy than 
a little too hard. 

Sentence Information 

style defines words as strings of characters separated by blanks and 
punctuation marks, style defines sentences as strings of words with 
length greater than three if it does not find a verb, and with any 
length if it does find a verb. Content words (nonfunction words) are 
nouns, adjectives, adverbs, and nonauxiliary verbs. Function words 
are prepositions, conjunctions, articles, and auxiliary verbs, style 
counts as short sentences those that are at least five words shorter 
than the average. It counts as long sentences those that are at least 
ten words longer than the average. 

style classifies sentences as simple, complex, compound, or 
compound-complex. The definitions used by style are slightly 
different from those in standard English grammar, style's definitions 
are listed below. 

The definitions of sentence type used by style are as follows: 1) A 
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simple sentence has one verb and no dependent clause. 2) A complex 
sentence has one independent clause and one dependent clause, each 
with one verb. Complex sentences are found by identifying sentences 
that contain either a subordinate conjunction or a clause beginning 
with words like "that" or "who." The preceding sentence is complex. 
3) A compound sentence has more than one verb and no dependent 
clause. Sentences joined by are also counted as compound. 4) A 
compound-complex sentence has either several dependent clauses or 
one dependent clause and a compound verb in either the dependent 
or independent clause. 

Word Use 

Verbs, style counts whole verb phrases as single verbs. The verb 
categories that style prints in the style table are not mutually 
exclusive. For example, the verb phrase "to be going" counts as both 
"to be" and "infinitive." 

style counts as passive those verbs occurring after a form of the verb 
"to be." The phrase will also be counted as passive if one or more 
adverbs are between the form of "to be" and the verb. However, if the 
"be" and the verb are separated by punctuation or words other than 
adverbs, the phrase will not be recognized as passive, style does not 
recognize some irregular past participles and subsequently does not 
recognize passive sentences containing them as passives. For example, 
style does not recognize the following sentence as passive: 

The car was hit by the truck. 


Nominalizations. style counts as nominalizations those words ending 
in "ment," "ance," "ence," or "ion" when they are used as nouns. 

3. style cannot recognize imperative sentences as such unless they are 
marked. A tilde (') immediately before the period (with no spaces 
between them) tells style the sentence is imperative. For example, 
style will correctly count the following sentence as an imperative: 

Unplug the coffee pot". 

Without the tilde, style would call "unplug” a noun. 

SEE ALSO 

deroff, match, mkstand, murky, parts, prose, prosestnd, reroff, wwb 

BUGS 

Use of non-standard formatting macros may cause incorrect sentence breaks. 

parts and style assume that the input text uses correct grammar. If it does 
not, they may make mistakes. 

EXAMPLE 

$ style exfile 

style -m m — i g exfile 

readability grades: 

(Kincaid) 11.9 (auto) 12.1 (Coleman-Liau) 12.6 (Flesch) 14.0 (43.4) 
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sentence info: 

no. sent 14 no. w3s 267 
av sent leng 19.1 av word leng 5.09 
no. questions 0 no. imperatives 0 
no. content wds 169 63.3% av leng 6.40 
short sent (<14) 29% (4) long sent ( >29 ) 7% (1) 

longest sent 46 wds at sent 9; shortest sent 3 wds at sent 4 
sentence types: 

simple 57% (8) complex 7% (1) 
ccmpound 29% (4) ccmpound-ccmplex 7% (1) 
word usage: 

verb types as % of total verbs (31) 
tobe 32% (10) aux 3% (1) inf 23% (7) 
passives as % of non-inf verbs 29% (7) 
types as % of total 

prep 9.7% (26) canj 7.9% (21) adv 3.7% (10) 
noun 30.7% (82) adj 18.0% (48) pron 0.7% (2) 
ncminalizatians 1 % (3) 
sentence beginnings: 

subject opener : noun ( 1 ) pran ( 0 ) pos ( 0 ) adj ( 3 ) art ( 6 ) tot 71% 
prep 7% (1) adv 21% (3) 

verb 0% (0) sub canj 0% (0) canj 0% (0) 
expletives 0% (0) 

EXAMPLE EXPLANATION 

1. The command line shows you want to see the style statistics for your 
file named exfile. 

2. style displays the options it is using. Here, it is using the default op- 
tions, — m m and — i g, as it runs on exfile. The program will run 
deroff to eliminate macros and text that is not part of sentences, and it 
will ignore lists in the analysis. 

3. Four readability scores are given. Since the Kincaid formula was 
based on adult reading material, the Kincaid score is usually the most 
appropriate. 

4. The output tells you how many sentences are in your text, what kind 
they are, and what the average sentence length is. The percentages of 
different sentence types in exfile are also given. 

5. The program next presents information on parts of speech. 

6. The last part of the output tells you what kind of sentence openers 
you used in your text. Variety in sentence openers helps preclude 
monotony. 
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NAME 

switchr — find words that switch grammatical roles 
SYNOPSIS 

switchr [— IsOV] [-i g|n] [-m m|n|s] [ rerof {-options ] [ — ] file ... 
DESCRIPTION 

switchr finds words in the input text that are used both as a noun and as a 
verb, that is, words that switch roles. A word used as both a noun and as a 
verb can confuse the reader, switchr uses the parts program to identify the 
part of speech of each word in the input text, switchr lists words that have 
been used as both a noun and a verb and asks if you want the list saved in 
your current directory in a file called sw. file. 

The long version (the —1 option, which is the default) also prints each sen- 
tence containing one of the words, with the word surrounded by asterisks and 
brackets, *[ ]*. 

Options are: 

-1 Produce a long version, which lists words used as both nouns 
and verbs and the sentences in the input text that contain those 
words. This is the default. (You can change this default by set- 
ting the environmental variable WWBLEV. See the note on the 
manual page for wwb.) 

-s Produce a short version, which is a list of the words used as both 
nouns and verbs. 

-O Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

-i g Ignore list items, as defined by mm macros, in the analysis. This 
is the default. 

-i n Include list items in the analysis. This option should be used if 
the text contains lists of sentences but not if the text contains 
lists of non-sentences. 

-m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 

— m n The input text does not contain macros; it is already formatted. 
The program uses reroff to identify text that is not part of sen- 
tences and eliminates that text from the analysis. 

-m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 

reroff-options 

Use only with the — m n option. 

-h All line-end hyphenated words will retain their hyphens in 
the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
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back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if num= 1, double-spaced if num=2, 
triple-spaced if num= 3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

— Delimit the end of options. 

NOTE 

If you use formatting header files (which can contain formatting commands 
and definitions of macros), include them as part of the input text. This is 
necessary because switchr runs deroff on files that contain formatting macros 
to strip non-sentence text from the input, and deroff needs to know about for- 
matting commands you have defined yourself in order to interpret them later. 
If your text is already formatted, you can use the — m n option to identify text 
that should be ignored in the analysis. 

SEE ALSO 

consist, deroff, reroff, parts 

FILES 

sw .file contains the list of words used as both nouns and verbs 

BUG 

Because switchr runs the parts program to determine the parts of speech of 
words in the input text, its accuracy is limited by that of parts, switchr may 
identify words used as parts of speech other than nouns or verbs. 

EXAMPLE 

Sswitchr exfile 

switchr — 1 -i g -m m exfile 

Based on the results of a parts of speech analysis, switchr finds the 
words in a document that are used as both a noun and a verb. Although 
this is not necessarily a problem, it nay be confusing to the reader. 

For file exfile, these words are: 

test 


beginning line 22 exfile 

The Denver Wildlife and Research Centre (EWRC) and the Bell Telephone 
Laboratories decided to join together to *[ test ]* the gopher 
resistance of the new designs. 

beginning line 25 exfile 

The manpower for the experiments cane from both EWRC and BTL; 

Bell prepared the *[ test ]* samples, took photographs after exposure 
to gophers, and analyzed the engineering implications of the results, 
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and the dwrc designed and conducted the exposure 
»[ test ]* and rated the damage to the samples. 

file exfile: number of lines 42 number of phrases found 3 

The words in file "exfile" 

that were used as both a noun and a verb 

are stored in file "sw. exfile." 

Do you want to save it? (y or n) 

>y 

EXAMPLE EXPLANATION 

1. The command line shows you want to locate words that are used both 
as a noun and as a verb in your text file called exfile. 

2. switchr displays the options it is using. Here, it is using the default, 
—1, to produce the long version of output, which lists the sentences 
containing words that switch roles, — i g, to eliminate list items, and 
— m m, to run deroff, which eliminates macros and text that is not part 
of sentences. 

3. The output reports that the word "test" is used as both a noun and 
verb in the text. 

4. The output shows the sentences that contain the word "test" with the 
beginning line number and the word surrounded by asterisks and 
brackets. In line 25, the word "test" is used as an adjective ("test sam- 
ples"). switchr will find a word used as an adjective when it also ap- 
pears in the text as a verb and as a noun. 

5. The program reports that there are 42 lines in your text and 3 phrases 
were found. 

6. switchr stores the word that is used as both a noun and as a verb in 
sw.exfile and asks whether to save that file. Type y or n after the ">" 
prompt. 
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NAME 

syl — syllable counter 
SYNOPSIS 

syl [-OV] [— L mim] [ — ] [-| file ...] 

DESCRIPTION 

syl counts the number of syllables in each word in the input text, which can 
be a file or words typed in at the terminal, syl prints each unique word in 
the file preceded by its syllabi e count. The words are ordered alphabetically 
within each syllable category, that is, all one-syllable words are printed first, 
in alphabetical order, followed by the two-syllable words, and so on. You can 
use the — L num option to print only words that have at least num syllables. 

When you give syl multiple input files, it treats them as one file and prints 
only one list. 

To use syl interactively, type syl RETURN and then type the word or words to 
be counted on the next line, syl will print the syllable count for each word. 
Type Ctrl-D (the CONTROL and the D keys at the same time), to exit the pro- 
gram. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— L num 

Only print words that have at least num syllables. 

— Delimit the end of options. 

— Use standard input. 

BUG 

Because there are minor rules and exceptions in English not covered by the 
syl program, the program is about 98% accurate. 

EXAMPLE 1 

$syl exfile ! pr -4 
May 8 14:46 1985 Page 1 


syl exfile 

1-not 

2-designs 

3-conducted 

1-al 

1— of 

2-diet 

3-consisted 

1-all 

1-an 

2-early 

3-decided 

1-an 

1-ar 

2-english 

3-developed 

1-and 

1-rack 

2-female 

3-difficult 

1-are 

1-ran 

2-fungi 

3-examples 

1-as 

1-rat 

2-given 

3-exposure 

1-been 

1-rats 

2-gopher 

3-extensive 

1-bell 

1-sex 

2-gophers 

3-bowever 

1-both 

1-sheathed 

2-harder 

3-incentive 

1-btl 

1-since 

2- insects 

3-manpower 

1-but 

1-size 

2-larger 

3-natural 

1-by 

1-such 

2-later 

3-organisms 

1 -caged 

1-test 

2-lizell 

3-photographs 

1-came 

1 -tests 

2-many 

3-randcmly 
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1 -cause 

1-that 

2-marine 

3-reported 

1 -caused 

1-the 

2-number 

3-reproted 

1 -centre 

1— to 

2-objects 

3-resistance 

1-chew 

1-took 

2-plastic 

3-resistant 

1-chow 

1-was 

2-prepared 

3-specimens 

1-dry 

1-were 

2-provide 

3-telephone 

1-dwrc 

1 -white 

2-rapid 

3-tendency 

1-et 

1-wire 

2-rated 

3-together 

1-food 

1 -wires 

2-research 

3-various 

1-for 

1-with 

2-results 

4-available 

1-frcm 

2-adult 

2-rodent 

4-bacteria 

1-gertsch 

2-after 

2-rodents 

4-biological 

1-have 

2-ary 

2-rubber 

4-engineering 

1 -housed 

2-attack 

2-sample 

4-experiments 


EXAMPLE 1 EXPLANATION 

1. The command line shows you want the syllable count for each unique 
word in exfile. The output is piped to the pr —4 command to print 
the list in four columns. 

2. syl displays the command line, showing that it is not using any de- 
fault options. 

3. All the words in the text are arranged alphabetically within each syll- 
able category. (The actual list is longer than shown.) 

EXAMPLE 2 

The command 

syl — L 5 exfile 

will print all the words in exfile that have five syllables or more. 

EXAMPLE 3 

The sequence 

$syl RETURN 

Who needs a dictionary? 

will print the syllable count for each word in the line. When finished, type 

Ctrl-D. 
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NAME 

tmark — identify incorrectly used trademarks and service marks 
SYNOPSIS 

tmark [— dlsOV] [— f dictionary-file] [ — ] file ... 

DESCRIPTION 

tmark locates and prints all sentences in a document that contain incorrectly 
used trademarks and service marks based on two dictionaries of trademarks, 
service marks, and common nouns, tmark identifies marks that do not 
modify the common name of the product or service they describe. The word 
or phrase in each sentence is surrounded with asterisks and brackets (*[ ]*), 
and the line numbers of the sentences are also given, tmark can also suggest 
corrections for the misused marks. 


If you have a file named $HOME/lib/wwb/ tmarkdict, tmark locates or 
ignores trademarks and service marks contained in that file, dictadd can be 
used to set up $HOME/lib / wwb / tmarkdict. dictadd prompts you to add 
marks to be located or ignored by tmark. 

When you use the —1 option and give tmark multiple input files, it will print 
one explanation, sentences from each file, and one table of corrections, 
tmarkrls provides information about rules for the correct use of trademarks 
and service marks, some of which tmark cannot check, tmark is one of the 
programs run by consist. 

Options are: 

— d Print the full pathname of the tmark dictionaries of trademarks 
and service marks, then exit. 

—1 Produce a long version, which explains the proper use of trade- 
marks and service marks, lists the sentences with possibly 
misused marks highlighted, and provides a table of suggested 
corrections for the misused marks. This is the default. (You can 
change this default by setting the environmental variable 
WWBLEV. See the note on the manual page for wwb.) 

— s Produce a short version, which lists sentences that contain possi- 

bly misused trademarks and service marks with the incorrectly 
used marks highlighted. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 


NOTE 


— f dictionary-file 

Use the user-specified dictionary, dictionary-file, in addition to 
the standard dictionary of trademarks and service marks. When 
the — f dictionary-file option is used, tmark does not check 
$HOME/ lib / wwb / tmarkdict for phrases, dictadd can be used to 
set up dictionary-file. 

— Delimit the end of options. 

tmark compares your text with two separate trademark dictionaries. If it finds 
misused phrases from both dictionaries, the list of sentences it produces will 
not be in sequence. Misused phrases from the first dictionary will be 
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FILES 


presented first, followed by those from the second dictionary. 


$HOME/ lib / w wb / tmarkdict 
/ usr / lib / w wb / tmrkwordsl.d 
/ usr / lib / wwb / tmrkwords2.d 
/ usr / lib / wwb / tmrksugg.d 
/ tmp/$$* 


produced by dictadd 

first half of tmark dictionary of trademarks 
second half of tmark dictionary of trademarks 
tmark dictionary of corrections 
temporary files 


SEE ALSO 

consist, dictadd, tmarkrls 


BUGS 

There are other rules for the correct use of trademarks and service marks that 
tmark cannot check. Use tmarkrls for more information. 

tmark uses a dictionary of mostly AT&T trademarks and service marks. If you 
use other marks, use dictadd to create a personal dictionary of marks. 

tmark does not always recognize that marks have been correctly used as adjec- 
tives when there are embedded formatting commands, such as font shifts. 
The only formatting commands tmark recognizes are: 


■ \(rg registered trademarks 

■ \*(Tm unregistered trademarks 

• \*(Sm unregistered service marks 

• .FS and .FE footnoted trademarks 

EXAMPLE 1 

Strtark marks 
tmark -1 marks 

Trademarks and service narks are any words, names, symbols, or 
devices used to identify and distinguish a product or service fran 
those manufactured car sold by others. Trademarks and service marks 
should always be used as adjectives preceding the cannon name of the 
product or service they describe. For example , marks such as UNIX* 
and PICTUREPHCNE** should never be used as nouns in phrases such as 
"learn UNIX" or "meet by PICTUREPHCNE." Instead, they should always be 
used as adjectives in phrases such as "learn to use UNIX Software" or 
"UNIX Operating Systems" and "use the PICIUREPHCNE meeting service" or 
"PICTUREPHCNE visual telephone service." 

In your document(s) , you may have used sane trademarks and/or 
service narks as nouns rather than as adjectives that modify the 
camon name of the product or service. This program will print a list 
of the sentences containing these possibly misused narks, followed by 
a table of corrections. The table shows acceptable cannon names for 
each nark to modify, although in sane cases there nay be others. 
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* UNIX is a trademark of AT&T Bell laboratories . 

** PICTOREFHCHE is a registered service nark of AT&T. 


NOTE: The tmark program will now compare your text with two 
separate trademark dictionaries. If it finds misused phrases 
from both dictionaries . the follcwing list of sentences will 
not be in sequence. 

Far the first trademark dictionary: 

file marks: number of lines 23 number of phrases found 0 
Far the second trademark dictionary: 
beginning line 15 example 

The legend TM (for exanple, UNIX *[ WRITER'S WCRKHENCH]* 

\*(Tm) following the trademark cm a product or appearing in 
a footnote shews that the trademark is protected under the canton 
law of one or more states through use of the mark in trade. 

file marks: number of lines 23 number of phrases found 1 

Please wait for a list of correct phrases. 


Table of Corrections 

TRADEMARK CCKREOT PHRASES 

WRITER S WORKBENCH: use "software, program, system" with " WRITER S WORKBENCH" 


NOTE: 

* There are other rules for the correct use of trademarks 
that tmark cannot check. Use the tmarkrls program for 
more information about these rules. 

* This program uses dictionaries of mostly AT&T 
trademarks and service marks. If you need to check 
your use of other narks, use dictadd to create a 
personal dictionary far tmark to use. 

* The tmark program does not always recognize that marks 
have been correctly used as adjectives when there are 
enbedded fornatting catnands. 

EXAMPLE 1 EXPLANATION 

1. The command line shows you want your text, marks, searched for in- 
correctly used trademarks and service marks. 
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2. tmark responds that it is using the default option, —l, to produce the 
long version of output. 

3. The program explains that trademarks and service marks should al- 
ways be used as adjectives before the common name of the product or 
service they describe and tells you that your document may contain 
incorrectly used trademarks or service marks. 

4. tmark compares your text to two separate dictionaries; the program re- 
ports the results from the first dictionary and then reports the results 
from the second one. marks does not contain incorrectly used trade- 
marks or service marks found in the first dictionary, but there is one 
possibly incorrect phrase found when the file is compared to the 
second dictionary, tmark reports the line number of the sentence and 
highlights the trademark with asterisks and brackets. 

5. tmark presents a Table of Corrections, and then the program explains 
several notes about its operation. It recommends that you use 
tmarkrls for more information. 

EXAMPLE 2 

The command 

tmark — f markfile marks 

will print sentences from marks that contain possibly incorrect trademarks or 
service marks and will include or suppress marks as specified in markfile. 
tmark will not reference $HOME/lib/wwb/tmarkdict when the — f option is 
used. 
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NAME 

tmarkrls - print a list of rules for the correct use of trademarks and service 
marks 

SYNOPSIS 

tmarkrls [— OV] 

DESCRIPTION 

tmarkrls prints information about the correct use of trademarks and service 
marks. The tmark and consist programs identify trademarks that are 
incorrectly used in the input text. Use dictadd to add trademarks and service 
marks to tmarkdict, the tmark personal dictionary. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

SEE ALSO 

consist, dictadd, tmark 

EXAMPLE 

Stmarkrls 

Trademarks and service marks are any words, names, symbols, 
or devices used to identify and distinguish a product or service 
from those manufactured or sold by others. The rights to a trade- 
mark or service mark can be lost if the nark is used inproper ly. 

The rules for the correct use of trademarks and service marks are 
listed below. 

1. Always use a trademark or service nark as an adjective 
modifying the camon name of the product or service. 

EXAMPLE: UNIXTM operating system 
(mark) (common name) 

2. Always make the trademark or service mark 
typographically distinct. 

EXAMPLE: WRITER'S WCRKEENCHTM Software 

In addition to using all capital letters, a mark may 
be made distinctive by using boldface type, by 
enclosing it in quotation narks, or by italicizing it. 

3. Always show the reader if the mark is registered. Use 
the registered mark symbol (an R enclosed in a circle) 
or an asterisk with a footnote to designate a 
registered trademark or service nark the first time it 
appears in the text. 

EXAMPLE: WE* 32000 Microprocessor 

* WE is a registered trademark of AT&T. 
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4. Never use a registration notice for unregistered 
marks. Instead, the first time a mark appears in the 
text, use an asterisk with a footnote or the letters 
"TM" to show that a trademark (or "SM" to show that a 
service itark) is an unregistered mark. 

EXAMPLE: VAX* 11/780 ccnputer 

* VAX is a trademark of Digital Equipment Corporation. 

5. The "IM," "SM," ard registered mark symbols can only be 
used when the author or the author's enployer owns the 
tradenerk or service mark. All others must use a 
footnote naming the mark's owner. (See example 4. ) 

EXAMPLE EXPLANATION 

1. The command line shows you want to see information about the 
correct use of trademarks and service marks. 

2. The output explains to you what trademarks and service marks are and 
gives examples of how to use them correctly. 
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NAME 

topic — find the topic of a document 
SYNOPSIS 

topic [— OV] [-i g|n] [-m m|n|s] [reroff-options] [ — ] [-|/j7e ...] 
DESCRIPTION 

topic prints the 20 most frequent nouns and adjective-noun pairs in the input 
text, which will give an idea of the topic of a document. Words and word 
pairs are printed from most to least frequent, in reverse alphabetical order 
within frequency groups. 

When you give topic multiple input files, it will print the most frequent word 
pairs from the entire set. topic is one of the programs that is run by mores- 
tyle. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 
tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— i g Ignore list items, as defined by mm macros, in the analysis. This 
is the default. 

— i n Include list items in the analysis. This option should be used if 
the text contains lists of sentences but not if the text contains 
lists of non-sentences. 

— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(You can change this default by setting the environmental vari- 
able WWBFMT. See the note on the manual page for wwb.) 

— m n The input text does not contain macros; it is already formatted. 
The program uses reroff to identify text that is not part of sen- 
tences and eliminates that text from the analysis. 

-m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 

reroff -op tions 

Use only with the — m n option. 

— h All line-end hyphenated words will retain their hyphens in 

the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if num=l, double-spaced if num= 2, 
triple-spaced if nnm=3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 
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— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

— Delimit the end of options. 

— Use standard input. 

NOTE 

If you use formatting header files (which can contain formatting commands 
and definitions of macros), include them as part of the input text. This is 
necessary because topic runs deroff on files that contain formatting macros to 
strip non-sentence text from the input, and deroff needs to know about for- 
matting commands you have defined yourself in order to interpret them later. 
If your text does not contain formatting commands, topic can use reroff to 
identify text that should be ignored in the analysis (use the — m n option). 

USES 

topic will usually give an idea of the input text's subject, and it can also be 
used to help generate keywords for indexing. 

SEE ALSO 

deroff, morestyle, parts, reroff 

BUG 

Because topic prints only 20 words or word pairs, some words that appear in 
the document as frequently as the last ones given in the output may not be 
printed. 

EXAMPLE 

$topic exfile 
topic -m m — i g exfile 
3 gophers 
3 damage 
2 specimens 
2 rodents 
2 dwrc 
2 cables 
2 animals 
1 white 
1 water 

1 various species 
1 took photographs 
1 test samples 
1 sheathed cables 
1 samples 
1 sample 
1 rodent attack 
1 results 
1 rat damage 
1 ran tests 
1 plastic materials 

EXAMPLE EXPLANATION 

1. The command line shows you want to know the 20 topics most fre- 
quently referred to in your text file named exfile. 
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2. topic displays the command line, showing that it is using the default 
options, — m m and — i g, as it runs on exfile. The program will run 
deroff to eliminate mm macros and text that is not part of sentences, 
and it will ignore lists in its analysis. 

3. The output tells you that "gophers" and "damage” are the topics ap- 
pearing most frequently; each appears 3 times. 

4. Each of the rest of the topics appeared in the text less frequently (1 or 
2 times). 
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NAME 

worduse — print information about correct usage of words and phrases 
SYNOPSIS 

worduse [— dOV] [ — ] [phrase ...] 

DESCRIPTION 

worduse searches a list of commonly confused and misused English words 
and phrases for your word or phrase. This list contains all the awkward and 
wordy phrases flagged by diction, as well as many other words, worduse 
describes the correct use of the word or phrase (if any), and compares it to 
any similar words or phrases. 

worduse is an interactive program. When you type worduse on a line with 
the input word or phrase, it will print the explanation and then prompt for 
another word or phrase. When you type worduse on a line by itself, it prints 
instructions before it prompts for a word or phrase. To quit, type q after the 
prompt. 

Options are: 

— d Print the pathnames of the worduse list of words and phrases 

and the dictionary of explanations, then exit. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— Delimit the end of the options. 

USES 

Use worduse as a supplement to diction, proofr, proofvi, and wwb to learn 
why words were flagged by diction, or use worduse to learn the difference 
between similar words. 

FILES 

/usr/lib/wwb/wdusesugg.d contains the list of words and descriptions 
/usr/lib/wwb/wdusewords.d contains list of worduse phrases 
SEE ALSO 

diction, proofr, proofvi, wwb 

EXAMPLE 1 

The command 

worduse one of the 

will print: 

CNE OF THE: THE ONLY CNE OF THE: [use correctly, sometimes 
wordy] If you must use these phrases at all, use CNE OF 

THE with a plural verb, THE ONLY CNE OF THE with a singular 
verb. . . . 

word? 
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EXAMPLE 2 

The command worduse will first print instructions, then 
word? affect 
will print: 

AFFECT: EFFECT: Affect is used most often as a verb. . . . 
and the program will prompt the user for another word. 
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NAME 

wwb — run proofr and prose 
SYNOPSIS 

wwb [— IsOV] [— f style-file] [— i g|n] [— m m|n|s] [— u t |e \o, standards- file] 
[reroff-options] [ — ] file ... 

DESCRIPTION 

wwb runs programs designed to aid writers and editors in editing documents. 
The wwb command runs modified versions of two major WRITER'S WORK- 
BENCH programs, proofr and prose, which in turn run other programs. 

proofr is an automatic proofreading system that searches for spelling and 
punctuation errors, consecutive occurrences of the same word, wordy or 
misused phrases, split infinitives, and misused articles, prose describes the 
writing style of a document, namely, readability and sentence characteristics, 
and suggests improvements, prose compares a document with standards for 
one of three document types: technical, educational, or a user-specified stan- 
dard. 

When you give wwb multiple input files, it will run on each file separately 
and in sequence. 

Options are: 

-1 Produce a long version of proofr and prose. This is the default. 
(See note 1 below to change this default.) 

— s Produce a short version of proofr and prose. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— f style-file 

If a file containing the style table exists as output from the style 
program or from a previous prose run, it may be specified so that 
prose need not run style again, styl.tmp can be used as the 
style-file The input text file must also be used with the — f 
option so proofr can find errors. 

— i g Ignore list items, as defined by mm macros, in the analysis. This 

is the default. 

— i n Include list items in the analysis. This option should be used if 

the text contains lists of sentences but not if the text contains 
lists of non-sentences. 

— m m The input text contains mm macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
(for example, headings) from the analysis. This is the default. 
(See note 2 below to change this default.) 

-m n The input text does not contain macros; it is already formatted. 
The program uses reroff to identify text that is not part of sen- 
tences and eliminates that text from the analysis. 

— m s The input text contains ms macros. The program uses deroff to 
eliminate the macros and any text that is not part of sentences 
from the analysis. 
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— u t Use standards for technical documents for comparison. This is 
the default. 

— u e Use standards for educational documents for comparison. 

— u o, standards- file 

Use standards contained in the user-specified standards-file for 
comparison. See mkstand to set up the standards-file. 

reroff-options 

Use only with — m n option. 

— h All line-end hyphenated words will retain their hyphens in 
the output, although the words will be put back together. If 
the — h option is not given, hyphenated words will be put 
back together without a hyphen. 

— B num 

The input text has between-line spacing equal to num, that is, 
the input is single-spaced if num= 1 , double-spaced if num=2, 
triple-spaced if num= 3, and so on. 

—I num 

The standard left-hand margin (indent) in the input file is at 
num character position. 

— P num 

The standard indent for paragraphs in the input file is at num 
character position. 

— Delimit the end of options. 

NOTES 

1. The default output length for WRITER'S WORKBENCH programs is long 
(—1). The 15 WRITER'S WORKBENCH programs with length options 
(abst, consist, continge, diction, diversity, morestyle, murky, neg, 
proofr, prose, sexist, spellwwb, switchr, tmark, and wwb) assume the 
—1 option if the WWBLEV variable in your .profile is not set or is set to 
1. You can change this default to short (the — s option) by setting 
WWBLEV— s in your .profile, and exporting WWBLEV. 

The two lines you must add to your .profile (in your $HOME direc- 
tory) to set the WWBLEV variable to s are: 

WWBLEV— s 
export WWBLEV 

To override the short default at any time, use the —1 (the letter "1", for 
long) option on the command line. 

conspell, dictadd, double, gram, punct, spelltell, worduse, and 
wwbhelp moderate their output length based on WWBLEV, but do not 
take the —1 or — s option. 

2. Many WRITER'S WORKBENCH programs run deroff to remove 
nroff/troff and mm formatting commands and associated text that is 
not part of sentences from the input text. These programs assume the 
input text contains mm macros if the WWBFMT variable in your 
.profile (in your $HOME directory) is not set or is set to m. 
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You can change this default to ms macros or no macros (the programs 
will assume the input text is formatted) with the WWBFMT variable. 
Set WWBFMT— s, for ms macros, or WWBFMT— n, the text is already for- 
matted, in your .profile, and export WWBFMT. (See the example 
•profile entry for WWBLEV in note 1 above.) 

The 12 WRITER'S WORKBENCH programs that use deroff (aero, conscap, 
consist, mkstand, morestyle, murky, parts, prose, style, switchr, 
topic, and wwb) check the WWBFMT variable, continge, findbe, and 
org also check the WWBFMT variable, but do not run deroff. To over- 
ride the macro default, use the — m m, — m s, or — m n options on the 
command line. (See also the note on the findbe manual page for for- 
matting information about findbe and continge.) 

3. If you use formatting header files (which can contain formatting com- 
mands and definitions of macros) include them as part of the input 
text. This is necessary because wwb runs deroff on files that contain 
formatting macros to strip non-sentence text from the input, and 
deroff needs to know about formatting commands you have defined 
yourself in order to interpret them later. If your text does not contain 
formatting commands, wwb can use reroff to identify text that should 
be ignored in the analysis (use the — m n option). 

FILES 

/tmp/$$* temporary files 

SEE ALSO 

deroff, diction, double, gram, mkstand, proofr, proofvi, prose, prosestnd, 

punct, reroff, spelltell, spellwwb, style, worduse, wwbhelp, wwbinfo 

BUGS 

See other manual pages for bugs in individual programs. 

EXAMPLE 

$wwb exfile 

May 6 09:32 1985 proofs —1 exfile Page 1 


****************************** SPELLING ******************************* 

Possible spelling errors in exfile are: 

Centre Lizell 

EWRC al 

Gertsch 

If ary of these words are spelled correctly, later type 
spelladd wordl word2 . . . wordn 
to have them added to your spelldict file. 


dwrc 

reproted 
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***************************** PUNCIUATICN ***************************** 
The punctuation in exfile is first described. 

0 double quotes and 0 single quotes 

0 apostropihes 

1 left parentheses and 1 right ones 

The program next prints any sentence that it thinks is 
incorrectly punctuated and follows it by its correction. 


line 13 

OLD: of rodent attack to cables 
NEW: of rodent attack to cables 


later, Lizell et. al. ran tests 
Later, Lizell et al. ran tests 


For more information about punctuation rules, type: 

punctrls 

***************************** DOUBLE WORDS **************************** 
For file exfile: 

and and appears beginning line 20 


***************************** WORD CHOICE ***************************** 

Sentences with possibly wordy or misused phrases are listed next, 
followed by suggested revisions. 

NOTE: proofr is using your file /a8/eg/lib/wwb/ddict for 
additional phrases. 
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For file exfile: 

beginning line 18 exfile 

May 6 09:32 1985 proofr —1 exfile Page 2 


P Since the early studies of gopher-resistant materials, an large 
*[ number of ]* new wire, cable, and designs have been developed 
and and many new materials are available. 

beginning line 22 exfile 

The Denver Wildlife and Research Centre (IWRC) and the Bell Telephone 
Laboratories decided to *[ join together]* to test the gopher 
resistance of the new designs. 

beginning line 25 exfile 

The *[ manpower]* far the experiments came frcm both DWRC and 
BTL; Bell prepared the test samples, took photographs after exposure 
to gophers, and analyzed the engineering implications of the results, 
and the dwrc designed and conducted the exposure test and rated 
the damage to the samples. 

beginning line 36 exfile 

The gophers were not separated *[ as to ]* size or sex. 
file exfile: number of lines 42 number of phrases found 4 
Please wait for the substitution phrases 


Table of Substitutions 


PHRASE 


SUBSTITOTICN 


as to: use "about, an, of" for " as to" 

as to: use "to" for " in such a way as to" 

as to: use "to" for " so as to" 

as to: use "whether" for " as to whether" 

as to: use "whether" for " the question as to whether" 

join together: use " join" far " join together" 

manpower: use "personnel, staff, workers" for " manpower" 

number of: use "enough" for " sufficient number of" 

number of: use "many" for " a large number of" 

number of: use "often" for " in a considerable number of cases" 

number of: use "several, many, seme" far " a number of" 

number of: use "seme" for " in a number of cases" 

number of: use "usually" far " except in a small number of cases" 


* Not all the revisions will be appropriate for your document. 

* When there is more than one suggestion for just one bracketed 
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ward, you will have to choose the case that fits your use. 

* Capitalized words are instructions, not suggestions. 

* To find out more about each phrase, type "worduse phrase." 

NOTE: If you want this program to look far additional phrases 
or to stop locking for sane, for instance to step 
flagging "impact," type the contend dictadd. 


May 6 09:32 1985 proof r -1 exfile Page 3 

******************************* GRAMMAR ************************** 
Possible grainratical errors: 

In exfile: 

article error: "an large" should be "a large" about line 19 
split infinitive: "to repeatedly chew " about line 38 

For information on split infinitives type: 

splitrls 


May 6 09:33 1985 prose -m m — i g — 1 -u t exfile Page 1 


BECAUSE TOUR TEXT IS SHORT (< 2000 WORDS 5. < 100 SENTENCES), 
THE POLDOWING ANALYSIS MAY HE MISLEADING. 

NOTE: Your document is being oarpared against standards 
derived fran 30 technical documents, classified as good 
by technical managers. 

READABILITY 

Hie Kincaid readability formula predicts that your text 
can be read by saneane with 12 ar mare years of schooling, 
which is a good score for documents like this. 

VARIATION 

Variation in sentence length, type, and openings 
prevents monotony. More i m p o rtantly, a lack of such 
variation suggests that every topic and every sentence has 
equal weight, which makes it difficult far the reader to 
pick out the important points. 

In this text 57% of the sentences are simple and 7% 
are ccnplex. These percentages should be closer together. 
The difference between these percentages, here 50, should be 
less than 30. In addition, 29% of the sentences are 
compound ard 7% are caipound-catplex, far a total of 36%. 
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Most good documents of this type have a cartoned compound 
percentage between 6% and 35%. 

Although the short, simple sentence is the most direct 
and comprehensible form for an individual sentence, 
overusing such sentences nay make a document seem 
disjointed. Writing instructors say that a document is 
better when less important ideas are grammatically 
subordinated to more important ones so that the grammatical 
structure emphasizes the logical structure. 

However, this text also contains nary compound and 
catpound-ccmplex sentences. Instead of combining sinple 
sentences, you might introduce variation by dividing seme of 
the carpound-oomplex sentences into ccnplex sentences. 

If any of the advice given above is contradictory, it 
is best to work on one problem. Look at how the scores an 
this text ccttpare with the s tandar ds Then work an the 
variables that are furthest fran the standards. Remember 
that all these sentence variables are related. For example, 
vhen you change a catpound sentence to two short, sinple 
sentences, you also: 

- decrease the percentage of catpound sentences, 

- increase the ratio of sinple sentences to ccnplex 

sentences, 

- decrease the average sentence length, 

- decrease the reading grade level of the text. 

May 6 09:33 1985 prose — m m — i g — 1 — u t exfile Page 2 

SENTENCE STRUCTURE 

Passives 

This text contains a higher percentage of passive 
verbs (29.0%) than is caiman in good documents of this 
type. The score for passive verbs should be below 28.6%. 
A sentence is in the passive voice when its grannetical 
subject is the receiver of the action. 

PASSIVE: The ball was hit by the boy. 

When the doer of the action in a sentence is the subject, 
the sentence is in the active voice. 

ACTIVE: The boy hit the ball. 

The passive voice is sometimes needed 


MANUAL PAGES 3-159 



wwb 


wwb 


1. to emphasize the object of the sentence, 

2. to vary the rhythm of the text, or 

3. to avoid naming an unimportant actor. 

EXAMPLE : The appropriations were approved. 

Although passive sentences are sometimes needed, 
psychological research has shown that they are harder to 
comprehend than active sentences. Because of this you 
should transform as many of your passives to actives as 
possible. You can use the style program to find all your 
sentences with passive verbs in them, by typing the 
following ccnmand when this program is finished. 

style -p p file 
Verb-Adjective Ratio 

You have a high verb-adjective ratio, which means that 
you have limited your modifiers appropriately. 

Naminalizatians 

You have appropriately limited your ncminalizations 
(nouns irade from verbs, e.g., "description" ) . 

PROSE OUTPUTS 

Oprticns 

You can request that prose use different standards 
when evaluating your document. Far example typing "-u e" 
with the prose ccnmand, e.g., 


May 6 09:33 1985 prose -m m -d g — 1 — u t exfile Page 3 


prose -u e file 

will compare your text against educational documents. 

A -s cptian will provide a very short version of the 
prose output. 


prose -s file 

If you already have a style table in a file, you can 
save time by using it as the input to prose rather than the 
textfile. To do this, precede the style table filename with 
a -f, e.g., 
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prose — f style-file 

All the options can be selected at the same time and 
listed in any order. 

prose -f style-file -s -u e 


Statistics 

The table of statistics generated by the program style 
can be found in your file styl.tmp. If you want to look at 
it type: 


cat styl.tmp 

You can also use the match program, which provides a better 
format, type: 


match styl.tmp 

If you are not interested in the file, remove it by typing: 
rra styl . tmp 

ORGANIZATION 

The prose program cannot check the content or 
organization of your text. One way to lock at the overall 
structure of your text is to use grep to list all the 
headings that were specified far the mm formatter. To do 
this, type: 


grep "\H' file 

You can also use the organization program, org, to look 
at the structure of your text. It will format your paper 
with all the headings and paragraph divisions intact, but 
will only print the first and last sentence of each 
paragraph in your text so you can check your flow of ideas. 

org file 

EXAMPLE EXPLANATION 

1. The command line shows you want to see the proof r and prose ana- 
lyses of exfile. 

2. wwb first runs proofr against your file, proofr displays the date and 
time, the command line (which shows that it is using the —1 option to 
produce the long output), and the page number of the output. 

3. proofr shows you your possible spelling errors first (DWRC, Gertsch, 
Lizell, etc.) 
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4. The punctuation in exfile is described, and possible punctuation errors 
and corrections are listed. 

5. The program lists occurrences of double words in your text. For exfile 
"and and" is highlighted by proofr. 

6. proofr next lists any wordy or misused words and phrases in exfile 
and the Table of Substitutions. 

7. wwb reminds you that it is checking your personal dictionary, ddict, 
by default. The pathname will be different for each user. 

8. Articles errors and split infinitives in exfile are reported. 

9. wwb next runs the prose program against your file, prose gives the 
date and time and displays the command line it is using and a page 
number for the output. The program is using the default option 
— m m to run deroff, — i g to eliminate list items, —1 to produce the 
long version of output, and — u t to compare your text to technical do- 
cuments. 

10. prose discusses the readability of exfile, exfile's sentence variation, the 
structure of the sentences, the different ways you can use prose, and 
few words about textual organization in general. 
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NAME 

wwbaid - provide on-line aid for the WRITER'S WORKBENCH system 
SYNOPSIS 

wwbaid [— OV] [cmds|instruct|map|openj topic command-name] 

DESCRIPTION 

wwbaid is an on-line user's aid that supplies information about the WRITER'S 
WORKBENCH system. 

Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

cmds Print a list of all WRITER'S WORKBENCH system commands. 

instruct 

Print 15 screens of information, including an introduction to the 
WRITER'S WORKBENCH system, a description of the notation and 
conventions, and instructions on how to use the wwbaid system. 

map Print the titles of papers, transcripts of talks, and related refer- 
ences about the WRITER'S WORKBENCH system. 

open Conduct an interactive question-and-answer session, wwbaid 
open gives the same information on topics and command-names 
as described for the following option, wwbaid topic command- 
name. 

topic command-name 

Provide information on seven topics (topic) for the WRITER'S 
WORKBENCH system command ( command-name ) that you 
specify. Topics and their definitions are: 

bugs List known bugs and limitations, 

description Describe what the command does, 

example Print an example of command usage. 

format Summarize the way in which a command-name 

and its arguments must be written to execute 
the command. 

index Print an index to WRITER'S WORKBENCH system 

functions. 

options List and explain options, 

uses Describe not-so-obvious uses. 

The recognized command-names are those given by wwbaid cmds. You must 
include both a topic (for example, bugs or uses) and a command-name (for 
example, proofr or prose). The topic, which can be any one of the seven 
listed above, can be any part of the word (beginning with its first letter) or 
the entire word, but it must appear before the command-name. 

The option all can replace a topic or a command-name. For example, you can 
type: 
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wwbaid all wwb to print all topics for the wwb command (bugs, 
description, etc.) 

wwbaid bugs all to print bugs for all WRITER'S WORKBENCH system 
commands 

wwbaid all all to print everything 

FILES 

/usr/lib/wwb/aiddoc 

a directory containing stored wwbaid output files 

SEE ALSO 

wwb 

EXAMPLES 

Below are three examples of ways you can use wwbaid to help you learn 
about the WRITER'S WORKBENCH system. These examples are followed by a 
detailed discussion of the program, which you can use as a tutorial. 

wwbaid instruct 

Begins the instruction session that introduces you to the WRITER'S WORK- 
BENCH system and shows you how to use the wwbaid system. 

wwbaid open 

Begins an interactive session between you and the computer, printing 
requested information about command-names. 

wwbaid options spellwwb or wwbaid o spellwwb 

Lists and explains options for spellwwb (a command-name), and then 
exits. 

All users of the WRITER'S WORKBENCH system will find the user's aid helpful. 
For the experienced user, it has many good memory-jogging features. For the 
newcomer, it can be used as a learning aid. 

On occasion, you may want a list of all the WRITER'S WORKBENCH system 
commands. To get a list, type: 

wwbaid cmds 

If you are not familiar with the WRITER'S WORKBENCH system or the user's 
aid, you might find it convenient to use the on-line instruction session as an 
introduction. You can access it by typing: 

wwbaid instruct 

When you are familiar with the seven topics that answer questions about 
WRITER'S WORKBENCH system commands, use the index topic to explore some 
of the features of the WRITER'S WORKBENCH system. Try the following 
scenario at your terminal: 

Swwbaid open 

For which WRITER'S WORKBENCH system contend do you want information? 

Type help if you need a list. 

To quit at any time, type "q" or hit the break key. 

Enter a oanmand, help, or quit. 
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The arrow (=>) is a prompt for you to type a WRITER'S WORKBENCH system 
command-name. Suppose you type proofr. The program will next ask you to 
enter a topic. (Your choices are: bugs, description, example, index, options, 
format, and uses.) If you chose description as your topic, the program would 
respond by printing a short passage describing the proofr program. Requests 
for other topics and other WRITER'S WORKBENCH system command-names will 
be handled similarly. Typing quit will end the session. 

You can type the word all as your response to a request for a topic and as a 
response to a request for a command-name, or as a response to both. You 
will get: 

1. all information on one command, if you type all instead of a topic 

2. all commands on one topic, if you type all instead of a command- 
name 

3. all information on all commands, if you type all all 

When you have become familiar with the WRITER'S WORKBENCH system and 
the user's aid, you may want to use a more direct route to information. 

For example, the commands: 

wwbaid index all and wwbaid i all 
will print the complete index, and then exit. 

Since every detail about the WRITER'S WORKBENCH system cannot be covered 
by the user's aid, the command wwbaid map will print a list of papers, re- 
prints of talks, and related references about the WRITER'S WORKBENCH system. 

Whenever you need a memory-jogger, type wwbaid for a list of the user's aid 
options. 
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NAME 

wwbhelp — print WRITER'S WORKBENCH system commands for a topic 
SYNOPSIS 

wwbhelp [— dOV] [- — ] [ word ...] 

DESCRIPTION 

wwbhelp searches a file of topics and the WRITER'S WORKBENCH commands 
that cover those topics. It prints the topic followed by the commands and 
options that can be used to get related information. 

When you type wwbhelp on a line with a word, it will print all lines in the 
file of topics and commands that contain that word and then prompt for 
another word. The word you type in can be a topic or a command. 

When you type wwbhelp on a line by itself, the program prints instructions 
and then prompts for a word. To quit, type q after the prompt. 

Options are: 

— d Print the pathname of the wwbhelp dictionary of topics and 

commands, then exit. 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

— Delimit the end of the options. 

FILES 

/ usr /lib / w wb / w wbhelp.d 

contains the list of topics and commands 


SEE ALSO 

wwb, wwbaid, wwbinfo 

EXAMPLE 

Jwwbhelp syl 

syllable counts for words syl file 

syllable counts longer than num syl — L num file 


When the prompt "word?" appears, type any mare words 
you want information about. 

When you wish to stop, type q. 

word? q 
$ 
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NAME 

wwbinfo — print table of WRITER'S WORKBENCH programs and functions 

SYNOPSIS 

wwbinfo [— OV] 

DESCRIPTION 

wwbinfo prints a table listing the WRITER'S WORKBENCH system programs 
and their functions. Some programs run other programs; subordinate pro- 
grams are indented. The output is paged on a Video Display Terminal (VDT) 
one screen at a time. 

The table is divided into six parts: 


■ On-Line Help with WRITER'S WORKBENCH Programs 

■ Programs for Proofreading 

■ Programs for Style Analysis 

> Programs to Analyze Procedural Documents 

■ On-Line Help with Grammar, Spelling, Punctuation, and Usage 

■ Programs to Customize Dictionaries and Standards 
Options are: 

— O Print the command line synopsis (see above) and a short descrip- 

tion of command options and arguments, then exit. 

—V Print the WRITER'S WORKBENCH system version number of the 
command, then exit. 

EXAMPLE 

Swwbinfo 

PROGRAM- FUNCTION TABLE 


On-Line Help with WRITER'S WORKBENCH Programs 


wwbaid describes programs and explains how to use them 

wwbhelp word gives information about programs and functions 

wwbinfo prints this FROGtAM-FUNCTION TABLE 


On-Line Help with Granmar, Spelling, Punctuation, and Usage 


prosestnd prints standards used by prose to evaluate documents 

cantinrls explains clear ways to present contingencies 

punctrls explains punctuation rules 

spelltell word finds the correct spelling of word 

splitrls explains split infinitives 

tmarkrls explains correct use of trade/service marks 

worduse word explains correct usage of wards ana phrases 
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Programs for Proofreading 
aero file finds acronyms 

consist file runs three consistency checking programs 

tnark file finds inaccurate trade/service marks (uses tmarkdict) 

canscap file checks for inconsistent capitalization 

canspell file lists words spelled inconsistently (British vs. American) 

proofvi file proofreads text and corrects errors interactively 

(runs spellwwb, punct, double, and diction) 

sexist file finds sexist phrases and suggests changes (uses sexdict) 

switchr file finds words used as both a noun and a verb 

wwb file runs proof r and prose 

proofr file runs five proofreading programs 

spellwwb f ile ... checks spelling (uses spelldict) 
punct file checks punctuation 

double file finds consecutive occurrences of the same word 

diction f ile .... finds awkward phrases, suggests changes (uses ddict) 
gram file finds split infinitives and wrong articles 

Programs for Style Analysis 

findbe file prints file and highlights all forms of the verb "to be" 

match style-file (s) . . .collates style-file statistics frem different texts 

norestyle file runs four additional stylistic analyses an text 

abst file evaluates text abstractness 

diversity file measures variety of vocabulary with type/token ratio 

neg file finds negative words, evaluates their overall effect 

topic file reports frequent words to give an idea of the topic 

org file prints condensed version of text to show organization 

parts file assigns grammatical parts of speech to words 

reroff file puts rrm/nroff macros back in an already formatted text 

syl file counts syllables of each different word in file 

wwb file runs proofr and prose 

prose file gives detailed commentary about the style of a file 

style file calculates and summarizes style statistics 

Programs to Analyze Procedural Documents 

cantinge file analyzes treatment of contingencies in procedural text 

murky file finds hard-to-understand sentences in procedural text 

Programs to Customize Dictionaries and Sta n da r ds 

dictadd adds phrases to user's personal dictionaries: 

ddict - personal dictionary of awkward phrases 
sexdict - personal dictionary of sexist terms 
spelldict - personal dictionary of correct spellings 
tmarkdict - personal dictionary of trade/service marks 

spelladd adds words to spelldict dictionary 

mkstard calculates standards for prose frem user documents 


Note Indented commands are autcmatically run by the caimand that 
immediately precedes them. Indented ccnmands can be run singly as well. 
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EXAMPLE EXPLANATION 

1. The command line shows you want wwbinfo to print the Program- 
Function Table. 

2. wwbinfo prints the table, asking you to press the carriage return to 
see more of the table after the screen fills with 24 lines of text. 
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Appendix A: Rationale for WRITER’S WORKBENCH 
Programs 


Introduction 


This paper describes the rhetorical and psychological writing principles 
that underlie the WRITER'S WORKBENCH programs. It is taken from a paper 
by Nina H. Macdonald, that appeared in the Bell System Technical Journal} 
Many of these principles are supported by research showing that indeed, 
different writing styles make a difference to the reader, and that text that 
violates these principles is more difficult to comprehend. 
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Sonne Principles of Good Writing Style 


This section describes some principles of good writing style. These 
principles belong to the word, sentence, paragraph, or document level, but 
of course, some principles overlap categories. 

Word Level 

There are several word level principles, such as using and spelling 
words correctly. 

Wordiness 

Style guides usually advise writers to avoid hackneyed, empty, or 
frequently misused phrases, such as "at this point in time" and 
"notwithstanding the fact that." 

Definite, specific, concrete language 

Strunk and White 2 remark that "the surest way to arouse and hold the 
attention of the reader is by being specific, definite, and concrete." They 
illustrate this principle by this pair of sentences, the first vague, the second 
concrete: 

A period of unfavorable weather set in. 

It rained every day for a week. 


Psychological research on memory and the imageability of words 
suggests that texts with many abstract words will be more difficult to 
remember, and presumably to understand, than texts with concrete 
words. 3,4 ' 5,6,7 

Word frequency and length 

Coleman 8 reported a high negative correlation between passage 
difficulty and the average frequency of content words. That is, texts made 
up of many infrequent words are difficult to comprehend. He also found 
that harder passages contained more letters, syllables, and morphemes per 
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word. Since frequency and length are highly correlated , 9 these two effects 
are possibly one effect. In keeping with these findings, Klare 10 recommends 
Anglo-Saxon-based words over Latin-based ones in English since the Latin 
form is usually longer, as in "go" versus "proceed." 


Negative Words 

Research shows that negation makes a text difficult to understand. As a 
general rule, simple affirmative sentences are easier to read and 
comprehend. Double negatives, such as "not unrelated," and terms like 
unless and except, should be avoided. The latter often contain hidden 
logical traps. Of course, there are occasions when a negative should be 
used, for instance, to provide contrasts for a reader, but often a negative just 
makes the reader transform a sentence into its positive form. 

Sentence Level 

There are several sentence level principles, for instance, using correct 
punctuation and correct grammar. Some of the less obvious, or more 
subjective principles, are described below. These are not principles of right 
or wrong, but rather of better or worse. 

Passive Voice 

A major writing problem, particularly in scientific writing, is the 
overuse of the passive voice. Historically the passive voice was used to 
show the objectivity of science and the scientist. The scientist did not state, 

I found that ...., but rather "It was found that ...." This usage was dogma, 
as Einstein said. When a man is talking about scientific subjects, the little 
word T should play no part in his exposition ." 11 

One problem with the passive voice in scientific materials is that its use 
has spread from obscuring "I" and "we" to many other cases as well, e.g., 

A variable-gain control is included in this circuit. 

Scientific objectivity is still served by stating. 

This circuit includes a variable-gain control. 
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Perhaps because of a change in scientists' perceptions of their role , 12 or 
perhaps because of the difficulty of the passive style, many scientists and 
scientific editors 13 ' 14 now recognize and even promote the use of the active 
voice, including the use of first-person pronouns. 

Why should we avoid the passive voice? The rhetoric books describe it 
as "dron[ing] like nothing under the sun," wordy and unclear , 15 and less 
direct and less vigorous 2 than the active voice. It may indeed be all those 
things, but in addition, psychological research has shown that the active 
versions of a sentence are recalled better 16 and verified faster . 17 Scientific 
texts written in the third person passive (It was concluded that...) are 
remembered less well and appreciated less than the same content written in 
the active voice . 18 

Kirkman 19 took samples of scientific papers and rewrote the content in 
six different styles. He asked scientists and engineers to rate which version 
they found "most comfortable to read, easiest to grasp and simplest to 
digest." In three different surveys, he found they preferred "direct, active 
writing, with a minimum of specialist vocabulary, a judicious mixture of 
personal and impersonal constructions, short and uncomplicated sentences 
and liberal paragraphing." 

These data do not imply that the passive voice should never be used; at 
times it is preferable: 

i. to emphasize the object of the sentence, 

ii. to vary the rhythm of the text, or 

iii. to avoid naming an unimportant actor. 

EXAMPLE: The mail was delivered. 


However, the passive voice should be restricted to the useful and necessary 
cases, rather than being used widely and indiscriminately. 

Nominalizations 

Nominalizations are nouns that have been created from verbs. They 
usually end in "ion," "ment," "ence," or "ance," e.g., "transformation," 
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establishment, and admittance." The empirical case against using 
nominalizations is strong. Coleman 20 found that individual sentences 
without nominalizations were remembered better than their nominalized 
forms. A multiple-choice comprehension test on content failed to show a 
significant difference between the two versions. But on a memory task, 
subjects required significantly more exposures to memorize sentences 
containing two nominalizations, than to memorize the same content written 
in active-verb form. 

In a later experiment, Coleman 16 investigated ten different types of 
nominalizations and their active versions. He found that for those pairs of 
sentences in which the active version was phrased in two clauses and the 
nominalized version in one, the active was memorized quicker. For 
example: 

ACTIVE: If he discusses the reason for the price-change, 
it will be appreciated. 

NOMINALIZED: His discussion of the reason for the 
price change will be appreciated. 

Coleman 20 took passages from a psychology text and rewrote all the 
nominalizations, passive sentences, and adjectivalizations into active 
sentences. (Coleman found no difference between adjectivalizations and 
their active forms.) He found that students answered correctly 25% more 
questions from the rewritten texts than from the originals. In a similar 
experiment, subjects were asked to write the passages immediately after 
reading them. Subjects recalled the simplified passages significantly better 
than the originals. 

Expletives 

In grammar, the term expletive refers to a syllable, word, or phrase that 
adds no information. In particular "expletives" are words such as "it" or 
"there," which expect a later word or phrase. Thus, in "There are three 
solutions to this puzzle," "There" is an expletive expecting "solutions." 

Many times such expletives can be deleted, e.g., "This puzzle has three 
solutions," although sometimes they cannot, e.g., "It is raining." Although 
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no research demonstrates that expletives make text more difficult, Brogan 21 
argues that when the expletive deemphasizes the main verb inappropriately, 
the sentence should be changed. For instance. 

It is this necessity that adds to their complexity, 
can be changed to 

This necessity adds to their complexity, 
making "adds" more salient. 

Paragraph Level 

Readability 

The readability or reading grade score for a text predicts how many 
years of schooling a reader would need to understand it. (Units other than 
years of schooling are sometimes used.) The prediction is usually based on 
the length of the words in the text and the length of the sentences. 

Different readability formulas both calculate the lengths and weight the 
factors differently. 

As mentioned in the previous section, the length of a word (highly 
related to its frequency) predicts its difficulty. Sentence length is related to 
sentence type, with complicated sentences usually containing more words 
than simple sentences. Readability formulas do a reasonable job of 
predicting how difficult material is, hot because sentence length and word 
length cause reading difficulty, but because they are highly correlated with 
features such as complexity and frequency, which do. 

As with any predictor, these formulas can be fooled. The Dale-Chall 
formula 22 takes vocabulary items into consideration, but most formulas do 
not and will provide incorrect readability scores for nonsense text. All the 
formulas will give the same values for text with the sentences input 
backwards or forwards. But, in general, the formulas give a reasonable 
prediction of text difficulty when presented with naturally written text. 

Unfortunately, research has shown 10 that the comprehensibility of a text 
is not necessarily improved, although the reading grade score is, by simply 
shortening words and sentences. The best way to improve the 
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comprehensibility of a text is to rewrite it following the principles of good 
writing. 

Variation 

In writing, as in most fields of endeavor, moderation is best. The 
previously described principles are not absolutes; some passives and 
nominalizations are reasonable, and, variation in sentence length, structure, 
and type is necessary to make writing interesting and keep the reader's 
attention . 12 Other more important reasons exist for providing variation in 
sentence type, that usually produce variation in length as well. 

Writing instructors suggest that less important ideas should be 
grammatically subordinated to more important ones so that the grammatical 
structure emphasizes the logical structure. Two simple sentences can be 
joined by using a "that" clause or an adverb, such as "although," to 
subordinate one to the other. The less important sentence should be in the 
subordinate clause after the "that" clause or adverb. For example, the 
following sentences: 

i. The short, simple sentence is the most comprehensible form for an 
individual sentence. 

ii. Overusing such sentences may make a document seem disjointed, 
can be combined: 

Although the short, simple sentence is the most 
comprehensible form for an individual sentence, 
overusing such sentences may make a document 
seem disjointed. 

The combined sentence subordinates sentence (i) to sentence (ii), thus 
emphasizing that the information in sentence (ii) is more important than 
that in sentence (i). 

Diversity 

A rich and diverse vocabulary can make a text interesting, but some 
documents (such as procedural directions) demand a small vocabulary for 
effective communication. The type /token ratio measures vocabulary 
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diversity— it can be used to check whether a text is unusual, when compared 
to others of its kind, and to study vocabulary differences among writers. It 
has been used to study how vocabulary changes as children grow up as well 
as other aspects of language. The ratio, which varies from near 0 to 1.0, is 
the number of different words in a text divided by the number of total 
words in the text. An exceptionally high diversity score suggests that the 
text goes from topic to topic, while an exceptionally low score suggests a 
narrow content focus. 

Document Level 

Organization 

Most books on writing recommend that the first sentence of each 
paragraph provide the topic of the paragraph or else provide a transition 
from the previous paragraph into a new topic. 2,12 If, for most paragraphs, 
the first sentence reflects the topic, then these sentences provide the reader 
with a reliable signpost to the meaning. Headings also provide signposts to 
topics and topic changes. A paper with good headings and topic sentences 
can be skimmed easily and quickly, and even the person who reads every 
word will find it easier to follow. 

Audience Considerations 

Style books are direct about advising writers to know their audience and 
to write for them. This is particularly important for materials such as 
instruction manuals, which the reader needs to understand. Writing for the 
reader extends from questions of vocabulary and sentence structure to 
content and organization. For content and organization. Flower 23 gives 
thorough advice. 
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Glossary 


abst 

Abstract term 

aero 

Acronym 

Active voice 

Argument 


Background process 

Bug 


The WRITER'S WORKBENCH program that 
evaluates how abstract a document is. 

A word that names an idea or quality you 
cannot perceive with the senses (for example, 
"truth" and "need"). 

The WRITER'S WORKBENCH program that finds 
acronyms in text. 

A word formed from the initial letters of a 
series of words or by combining initial letters 
and portions of a series of words (for example, 
AT&T for American Telephone & Telegraph). 

A verb form that indicates the subject of the 
sentence is performing the action. For example, in 
the sentence, "Mary wrote the book," the verb 
"wrote" is in the active voice. (See Passive voice for 
comparison.) 

A modification to a command option that alters 
output or command processing. On the command 
line, arguments are separated from the command by 
a space. For example, the wwb option — m takes 
one of three arguments: m, n, or s. An example 
command line is: wwb — m n filel. 

A type of program execution where the shell 
runs a command away from the interaction 
between you and the computer. 

A problem in a computer program. 
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Clause 

A group of words, containing a subject and a 
predicate, that is part of a compound or complex 
sentence. In the complex sentence, "I'll be at 
the airport when the plane arrives," the clause 
"I'll be at the airport" is an independent clause 
because it could stand alone as a sentence. But 
"when the plane arrives" is a dependent clause 
because it cannot stand alone. 

Command 

An instruction a user types at a computer 
terminal keyboard. Computer programs are 
often referred to as commands. 

Command line 

A line a user types into a computer containing a 
command (program name) by itself or a 
command with option(s), argument(s), and 
filename(s). 

Command line synopsis 

The notation that shows the correct way to type 
in a command, with and without options and 
arguments. 

Complex sentence 

In English grammar, a sentence containing an 
independent clause and one or more dependent 
clauses. For example, the sentence, "When the 
rain stops, we'll leave," is a complex sentence 
because it contains the dependent clause, "When 
the rain stops," and the independent clause, 

"we'll leave." The style program identifies 
complex sentences as those with one 
independent and one dependent clause, each 
with one verb. 

Compound-complex sentence 

In English grammar, a sentence containing two 
or more independent clauses and at least one 
dependent clause. For example, the sentence, 
"Someone rang the doorbell, but Mother, who 
was pouring tea, ignored the bell," is 
compound-complex. "Someone rang the 
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Compound sentence 


conscap 


consist 


conspell 


continge 


doorbell" and "but Mother ... ignored the bell" 
are independent clauses; "who was pouring tea" 
is a dependent clause. The style program 
identifies compound-complex sentences as those 
with several dependent clauses, or one 
dependent clause and a compound verb in 
either the dependent or the independent clause. 

In English grammar, a sentence of two or more 
independent clauses, often joined by a 
conjunction(s). For example, in the sentence, 
"She hit me and I fell," "She hit me" is an 
independent clause, as is "I fell"; "and" is the 
conjunction. The style program identifies 
compound sentences as those with more than 
one verb and those joined by a semicolon (;). 

The WRITER'S WORKBENCH program that finds 
inconsistent capitalization. The program finds 
words that appear in all upper-case letters and 
also appear in all lower-case or with only the 
first letter capitalized. 

The WRITER'S WORKBENCH program that runs 
three consistency checking programs (tmark, 
conscap, and conspell) that find both 
inaccuracies in trademarks and service marks, 
and inconsistencies in capitalization and British 
and American spelling. 

The WRITER'S WORKBENCH program that 
identifies inconsistent use of British and 
American spelling in the same document. 

The WRITER'S WORKBENCH program that 
analyzes the wording of contingencies in 
procedural documents. (See also murky and 
Procedural document.) 
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continrls 


Copy editing 


Cursor 


ddict 


Default 


Dependent clause 


deroff 


dictadd 


diction 


The WRITER'S WORKBENCH program that 
explains clear ways to present contingencies or 
decision points. 

A check for incorrect punctuation, spelling, and 
word usage in text. 

The marker on the screen that shows where the 
next character will be entered, corrected, or 
deleted. 

The WRITER'S WORKBENCH system dictionary 
containing a personal list of awkward phrases 
for diction to find or ignore, ddict is always 
stored in the directory $HOME/lib/wwb. 

In a computer system, the standard way a 
program will perform. The standard 
performance of a program can usually be 
changed with command line options. 

A clause that cannot stand alone as a sentence. 
For example, in the sentence, "The teacher said 
that the answer was correct," "that the answer 
was correct" is the dependent clause. 

Filters out all nroff and troff formatting 
requests as well as mm and ms macros, deroff 
can also be used to filter out non-sentence text, 
such as headings, and thus pass only sentences 
to the stylistic programs. 

The WRITER'S WORKBENCH system 
environmental tailoring program that adds 
phrases to the ddict, sexdict, spelldict, and 
tmarkdict dictionaries. 

The WRITER'S WORKBENCH program that finds 
awkward and commonly misused phrases in 
your text and suggests changes. 
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Diction 

Dictionary 

Directory 

diversity 

double 

ed 

Ellipses 

Environmental tailoring 

Expletive 


The choice and use of words in speaking or 
writing. 

(See User-specified dictionary and Standard 
WRITER'S WORKBENCH system dictionaries.) 

In the UNIX operating system, a directory is the 
repository for your files or other directories. 
UNIX system directories are arranged 
hierarchically. (See also Pathname.) 

The WRITER'S WORKBENCH program that 
measures the variety of vocabulary with the 
type /token ratio for a document. The unique 
content words in a text are divided by the 
number of total content words in the text to 
measure the diversity of the language used. 

The WRITER'S WORKBENCH program that finds 
consecutive occurrences of the same word in 
input text. 

An interactive line editor used to build and 
revise files in the UNIX operating system, ed 
allows you to manipulate text on a line-by-line 
basis. (See also vi.) 

In writing or printing, the periods or series of 
periods (...) used to indicate the omission of 
words. In this manual, ellipses are used in 
command line synopses to indicate that you 
have the option to type more than one filename 
(or other operand, such as a word). 

When using the WRITER'S WORKBENCH system, 
commands that let you customize the programs 
for your working environment. For example, 
dictadd, spelladd, and mkstand are commands 
for environmental tailoring. 

A word added to or inserted in a sentence to fill 
it out. Expletives have no content and include 
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Export 

Fill mode 

findbe 

Formatted file 

Formatting commands 

Formatting macros 
Function 
Global command 

gram 

$HOME 


such words as "it" and "there," in sentences like 
"It is raining" and "There are three solutions to 
this problem." 

Exporting a variable makes the variable 
available to other shell processes created by the 
current shell. 

Input text is arranged so that the greatest 
number of words can fit on a line of specified 
length when the text is output. 

The WRITER'S WORKBENCH program that locates 
all forms of the verb "to be" in the input text. 
Forms of "to be" are capitalized and underlined, 
thus identifying possibly wordy or unclear 
constructions. 

A text file that is the output of a formatting 
program, such as mm or nroff, or one that was 
typed in as though on a typewriter. A 
formatted file looks the way it will on paper, 
that is, it has left and right margins and spacing 
between paragraphs. 

(See nroff and troff formatting requests and 
mm and ms macros.) 

(See mm and ms macros.) 

A task done by the computer. 

A command that performs the requested action 
on all instances in the file. 

The WRITER'S WORKBENCH program that finds 
misused articles and split infinitives. (See also 

splitrls.) 

A symbolic UNIX system variable representing 
your login directory. 


Imperative sentence 


Independent clause 


Infinitive 


Interactive program 


Login directory 


Macro 


manual page 


match 


Mean 


A sentence expressing a command or request. 
For example, "Stop the car!" is imperative. In 
imperative sentences, the subject "you" is 
usually implied, but not stated. 

A clause that can stand alone as a sentence. For 
example, in the sentence, "Since no one 
volunteered, James did the work," "James did 
the work" is the independent clause. 

A verb form that is not inflected to indicate 
person, number, or tense. For example, in the 
sentence, "I want to ski this winter," "to ski" is 
the infinitive. (See also splitrls.) 

A program that allows you to engage in 
"conversations" with the computer. Programs 
are usually submitted through a typewriter-like 
keyboard attached to a display device. 

The directory, usually named with your login 
name, that you enter once you are logged in 
operating system successfully. $HOME is the 
symbolic name for the login directory. 

A collection of nroff or troff formatting 
requests that are invoked by name (see mm and 
ms macros). 

A detailed description of each command 
together with the command line synopsis, 
option and argument definitions, examples, and 
bugs. 

The WRITER'S WORKBENCH program that 
collates WRITER'S WORKBENCH system style 
statistics from different input texts. 

A statistic that indicates the middle point, 
quantity, or state between two extremes, an 
average. 
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Minicomputers 

mkstand 

mm and ms macros 


morestyle 

murky 


neg 

No-fill mode 

Nominalization 
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The AT&T 3B20 computer (plus many more). 

The WRITER'S WORKBENCH system 
environmental tailoring program that builds a 
writer's or group's personal set of stylistic 
standards for the WRITER'S WORKBENCH system. 

Packages of general purpose text formatting 
macros that tell a program how to create 
headers, titles, footnotes, and various jobs of 
complicated text formatting, mm and ms 
macros usually start with a period (.) and have 
two upper-case character names. (See also nroff 
and troff formatting requests.) 

The WRITER'S WORKBENCH program that 
analyzes text for style by running the abst, 
diversity, neg, and topic programs. 

The WRITER'S WORKBENCH program that finds 
hard-to-understand sentences in procedural 
documents. The program checks for passive 
voice, excessive sentence and word length, and 
poorly worded contingencies. (See also 
continge, continrls, and Procedural document.) 

The WRITER'S WORKBENCH program that finds 
negative words in documents and evaluates 
their overall effect. 

Text is printed out exactly as it is typed in, that 
is, output text is neither filled or adjusted (right 
margin remains ragged and text may extend 
beyond the current line length). 

A noun made from a verb. For example, 
"description" is derived from the verb "describe." 
The WRITER'S WORKBENCH system identifies 
nominalizations as words that end with "ion," 
"ment," "ence," and "ance." 


Nonrestrictive clause 


nroff formatting requests 

On-line reference 
Operating system 

Option 

org 

parts 

Passive voice 


A clause that is descriptive of, but not essential 
to, the meaning of the sentence element it 
modifies. For example, in the sentence, "We 
decided to hire Fred, who knows how to cook," 
"who knows how to cook" is a nonrestrictive 
clause describing Fred. (See also Restrictive 
clause.) 

Commands that can be put into a text file to tell 
a program how to format input text for 
typewriter-quality printers, nroff requests 
perform single, low-level operations, such as 
leaving a space, mm macros combine several 
nroff requests to do one higher level function. 
(See also troff formatting requests and mm and 
ms macros.) 

Information stored in the computer. 

The software system on the computer that 
controls execution of the programs. 

A character(s) used in a command line to 
modify program output by changing the 
execution of a command. For example, in the 
command line proofr — s exfile, — s is an option 
that produces the short version of the output. 
The long version (—1) is the default. 

A WRITER'S WORKBENCH program that shows 
the organization of a text. It formats input text, 
retaining only headings and the first and last 
sentences of each paragraph. 

The WRITER'S WORKBENCH program that 
assigns grammatical parts of speech to each 
word in the input text. 

A verb form using the verb "to be." Passive 
voice indicates that the grammatical subject is 
the receiver of the action. For example, in the 
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$PATH 

Pathname 

Permissions 

Phrase 
Pipe ( | ) 

Procedural document 

.profile 


Program 

proofr 


sentence, "The cake was made by Mary," the 
verb form "was made" is in the passive voice. 
Research shows that sentences written in the 
passive voice are harder to understand than 
those in the active voice, for example, "Mary 
made the cake." 

A symbolic variable that tells the UNIX 
operating system where to look for programs. 
$PATH is usually set in your .profile. 

A sequence of directory names followed by a 
filename, each separated by a forward slash (/), 
for example, $HOME/reports/progress. 

A means of allowing or denying access to a 
computer file or directory. Permissions can be 
changed with the UNIX system chmod 
command. 

A sequence of two or more words that is not 
necessarily a complete grammatical unit. 

A way to connect the output of one program to 
the input of another program, so the two run in 
sequence. (See also Vertical bar.) 

Text that leads a user through a series of steps 
to obtain a specific result. 

An executable file in your login directory that 
the UNIX system reads when you log in. It 
usually sets exported variables (WWBLEV and 
WWBFMT) used to tailor your environment and 
terminal modes. 

A collection of instructions or commands that 
cause the computer to perform a specific task. 

The WRITER'S WORKBENCH program that runs 
five proofreading programs, spellwwb, punct, 
double, diction, and gram. 
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proofvi 


prose 

prosestnd 

punct 

punctrls 

Readability level 


Reading level 
Requests 


reroff 


The WRITER'S WORKBENCH program that 
proofreads text (by running the spellwwb, 
punct, double, and diction programs) and 
provides interactive error correction with a 
menu system and access to a vi-like screen 
editor. (See also vi.) 

The WRITER'S WORKBENCH program that 
provides extended editorial comments on, and 
stylistic analysis of (by running the style 
program), input text. 

The WRITER'S WORKBENCH program that prints 
the standards used by the prose program to 
evaluate documents. 

The WRITER'S WORKBENCH program that finds 
incorrect punctuation in input text and explains 
how to correct it. 

The WRITER'S WORKBENCH program that 
explains punctuation rules. 

An estimate of the number of years of schooling 
a person needs to understand a document. The 
score is mainly based on word and sentence 
lengths. The style command lists four measures 
of the readability level of a text. 

(See Readability level.) 

Built-in commands recognized by the 
formatters. Requests are the simplest formatting 
commands available in the nroff and troff 
formatting language. They do a single task, as 
opposed to a macro which can perform multiple 
tasks. Requests usually start with a period (.) 
and have two lower-case character names. 

The WRITER'S WORKBENCH program that 
converts formatted text into an mm /nroff input 
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Restrictive clause 


sexdict 


sexist 


Shell 


Simple sentence 


spelladd 


spelldict 


spelltell 


file. This program is designed as the first 
operation for the stylistic programs. 

A clause limiting the use of the word or word 
group that it modifies, thus being essential to 
the meaning of the sentence. For example, in 
the sentence, "Bring me the book that is lying 
on the table," "that is lying on the table" defines 
the book and is a restrictive clause. (See also 
Nonrestrictive clause.) 

The WRITER'S WORKBENCH system dictionary 
containing a personal list of sexist phrases, 
sexdict is always stored in the directory 
$HOME/lib/wwb. 

The WRITER'S WORKBENCH program that locates 
possibly sexist words and phrases in text and 
suggests changes. 

A UNIX program responsible for handling all 
interaction between you and the computer. 

In English grammar, a sentence having no 
subordinate clauses. For example, "The cat 
purred." The style program identifies simple 
sentences as those with one verb and no 
dependent clause. 

The WRITER'S WORKBENCH system 
environmental tailoring program that adds 
words to the spelldict dictionary. 

The WRITER'S WORKBENCH system dictionary 
containing a personal list of correctly spelled 
words, spelldict is always stored in the 
directory $HOME/lib/wwb. 

The WRITER'S WORKBENCH program that finds 
the correct spelling of commonly misspelled 
words. 


G-12 


The WRITER'S WORKBENCH program that checks 
for spelling errors in the input text. 

The WRITER'S WORKBENCH program that 
explains split infinitives. 

The infinitive form of a verb with an element, 
usually an adverb, interposed between "to" and 
the verb form. For example, in the sentence, 
"Sam needed to quickly walk," "to quickly walk" 
is the split infinitive. The infinitive "to walk" is 
split by "quickly." Split infinitives usually 
sound awkward although they are not wrong 
technically. 

A statistic used as a measure of dispersion in a 
distribution. In statistics, when scores are 
normally distributed, about 68 percent of the 
scores will fall within one standard deviation 
above or below the mean. About 5 percent of 
the scores will fall above or below 2 standard 
deviations from the mean. 

Standard WRITER'S WORKBENCH system dictionaries 

Dictionaries, supplied with the WRITER'S 
WORKBENCH system, that some programs use 
automatically. Their locations can be found 
with the — d option with programs that use 
them. 

style The WRITER'S WORKBENCH program that 

produces tabular statistics on input text. It 
provides statistics on readability level, 
sentences, and word usage. It can also find 
sentences with certain characteristics. 

Stylistic programs Programs that analyze text at the sentence level 

by running parts. They are mkstand, 
morestyle, murky, parts, prose, style, switchr, 
topic, and wwb. 


spellwwb 

splitrls 

Split infinitive 

Standard deviation 
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switchr 

syl 

Syllable 


Synopsis line 
Syntax 


Text editor 
Tilde 


tmark 

tmarkdict 


tmarkrls 


The WRITER'S WORKBENCH program that finds 
words in the input text that "switch roles," that 
is, are used as both a noun and as a verb. 

The WRITER'S WORKBENCH program that counts 
the number of syllables in each word in the 
input text. 

A unit of spoken language consisting of a vowel 
or diphthong alone, syllabic consonant alone, or 
consisting of either with one or more 
consonants. 

(See Command line synopsis.) 

In English, the way in which words are put 
together to form phrases and sentences. In the 
UNIX operating system, the way in which 
program names, options, option arguments, and 
operands are put together to form a command. 

(See ed.) 

A diacritical mark (*) that is often used as a 
special symbol for computer programs, parts 
interprets a tilde before a period as marking an 
imperative sentence. A tilde before a phrase in 
the ddict dictionary signals diction to ignore 
that phrase if it occurs in text. 

The WRITER'S WORKBENCH program that finds 
inaccurately used trademarks and service marks. 

The WRITER'S WORKBENCH system dictionary 
containing a personal list of correctly spelled 
words, tmarkdict is always stored in the 
directory $HOME/lib/wwb. 

The WRITER'S WORKBENCH program that 
explains the correct use of trademarks and 
service marks. 
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The WRITER'S WORKBENCH program that prints 
the 20 most frequent nouns and noun-adjective 
pairs in the input text and their frequencies. 

Commands that can be put into a text file to tell 
a program how to format input text to produce 
high-quality printed text on a phototypesetter. 
(See also nroff formatting requests and mm and 
ms macros.) 

Type /token ratio The number of distinct content words in a text 

divided by the number of total content words in 
the text, diversity computes the type /token 
ratio to provide a measure of the diversity of 
the language used in a document. 

UNIX operating system The computer operating system on which the 

WRITER'S WORKBENCH system runs. 

UNIX System Administrator 

The person who maintains and watches over 
UNIX computer systems. 

User-specified dictionary A dictionary created by the user with the 

dictadd or spelladd command, to be used by 
diction, spellwwb, tmark, or sexist, or 
programs that run them. Your personal phrase 
and spelling dictionaries are: ddict, spelldict, 
sexdict, and tmarkdict. (See also Standard 
WRITER'S WORKBENCH system dictionaries.) 

Varied sentences Sentences are varied when different sentence 

lengths, types, and openers are used. 

Variable A symbol that may assume any one of a set of 

values within a program. 

VDT Video display terminal. 

Vertical bar ( | ) Used in the command line synopsis to indicate 

"or"; for example, [— m m|n|s] means you can use 
-m m or — m n or -m s. (See also Pipe.) 


topic 


troff formatting requests 
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vi A visual screen editor where the screen of your 

terminal acts like a window through which you 
look at the file. (See also ed.) 

worduse The WRITER'S WORKBENCH program that 

explains the correct usage of words and phrases 
often misused in writing. 

WRITER'S WORKBENCH system 

An integrated set of computer programs that 
analyze and evaluate input text and provide 
information about English usage. 

wwb The WRITER'S WORKBENCH program that 

proofreads and analyzes the style of input text 
by running the proofr and prose commands. 

The WRITER'S WORKBENCH program that 
describes WRITER'S WORKBENCH programs and 
explains how to use them. 

A variable in your .profile that is checked by 
WRITER'S WORKBENCH programs that run deroff 
and others. If it is not set or set to equal m, 
deroff assumes the text contains mm macros. If 
it is set to s, it means the text contains ms 
macros, and n means formatted text. 

The WRITER'S WORKBENCH program that gives 
information about WRITER'S WORKBENCH 
programs and functions. 

The WRITER'S WORKBENCH program that prints 
a list of WRITER'S WORKBENCH programs and 
functions. 

WWBLEV A variable in your .profile that is checked by 

WRITER'S WORKBENCH programs with length 
options. If it is not set or set to equal 1, the 
program produces the long version of output. If 
it is set to s, the program produces the short 
version. 


wwbhelp 


wwbinfo 


wwbaid 


WWBFMT 
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